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Foreword 

This Technical Specification (TS) has been produced by the 3"* Generation Partnership Project (3GPP). 

The contents of the present document are subject to continiung work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 
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1 Scope 

The present document covers the minimum characteristics considered necessary in order to provide comphance to 
GSM 03.19 [7]. 

The present document describes the technical characteristics and methods of test for testing the SIM API for Java 
Card™ [7] implemented in the subscriber identity modules (SIMs) for GSM. It specifies the following parts: 

- test applicabiUty; 

- test envirormient description; 

- tests format; 

- test area reference; 
conformance requirements; 

- test suite files; 

- test procedure; 

- test coverage; and 

- a description of the associated testing tools that shall be used. 

2 References 

The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version apphes. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[1] (void) 

[2] (void) 

[3] GSM 11.11: "Digital cellular telecommunication system (Phase 2+); Specification of the 

Subscriber Identity Module - Mobile Equipment (SIM - ME) interface". 

[4] GSM 11.14: "Digital cellular telecommunications system (Phase 2+); Specification of the SIM 

Application Toolkit (SAT) for the Subscriber Identity Module - Mobile Equipment (SIM - ME) 
interface". 

[5] GSM 1 1.17: "Subscriber Identity Module (SIM) test specification". 

[6] (void) 

[7] GSM 03.19: "Digital cellular telecommunications system (Phase 2+); Subscriber Identity Module 

Application Programming Interface (SIM API); SIM API for Java Card™; Stage 2 
(Release 1998)". 

[8] GSM 03.48: "Digital cellular telecommunications system (Phase 2+); Security mechanisms for the 

SIM appUcation toolkit; Stage 2 (Release 1999)". 
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[9] ISO/IEC 7816-3 (1997): "Information technology - Identification cards - Integrated circuit(s) cards 

with contacts - Part 3: Electronic signals and transmission protocols". 

[10] GSM 02.19 "Digital cellular telecommunications system (Phase 2+); Subscriber Identity Module 

Application Programming Interface (SIM API); Service description; Stage 1 (Release 1998)". 

[11] SUN Java Card Specification: "Java Card 2. 1 API Specification" . 

[12] SUN Java Card Specification: "Java Card 2.1 Runtime Environment Specification". 

[13] SUN Java Card Specification: "Java Card 2. 1 VM Architecture Specification" . 

[14] ETSI TS 101 220: "Smart Cards; ETSI numbering system for telecommunication applications 

providers". 

[15] GSM 11.10-1: "Digital cellular telecommunication system (Phase 2+); Mobile Station (MS) 

conformance specification; Part 1: Conformance specification". 

3 Definitions and abbreviations 
3.1 Definitions 



For the purposes of the present document, the terms and definitions given in GSM 11.10-1 [15] and the following apply: 
applet: application built up using a number of classes which wiU run under the control of the Java Card virtual machine 
applet installation parameters: default values for applet installation parameters 

applet loading script: file containing the APDU commands that will load and install the test applet in the card 
CleanUp Script file: file containing the APDU commands that will restore the Default Initial Conditions on the SIM 
Conformance Requirement Reference: description of the expected card behaviour according to GSM 03.19 

expected state: the state in which the SIM is supposed to be after the execution of the test procedure applied on the 

relevant initial conditions 

security parameters: minimum security requirements defined for the applet installation process 
Test Area: set of Test Cases applicable to a specific part ( class method, framework behaviour,...) of the GSM 03.19 
Test Case: elementary test that checks for compliance with one or more Conformance Requirement References 
Test Output ffle: TBD 

test procedure: the sequence of actions/commands to perform all the test cases defined in a test area 
Test Script file: file containing the APDU commands that will execute and verify the test results 
Test Toolkit Applet: applet designed to test a specific functionality of the SIM API GSM 03.19 

3.2 Abbreviations 

For the purpose of the present document, the abbreviations given in GSM 01.04 [2] and the following apply: 

AC Application Code 

AID Application IDentifier 

APDU Application Protocol Data Unit 

API Application Programming Interface 

APT APplet Triggering 

CAD Card Acceptance Device 

CRRC Conformance Requirement Reference Context error 
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CRRN 


Conformance Requirement Reference Normal 


CRRP 


Conformance Requirement Reference Parameter error 


ERP 


Envelope Response Posting 


EXH 


Exception Handling 


FFS 


For Further Study 


FSC 


File System Context 


FWS 


Frame Work Security 


HIN 


Handler INtegrity 


IFD 


InterFace Device 


JCRE 


Java Card^**^ Run time Environment 


JVM 


Java Virtual Machine 


MHA 


Minimum Handler Availability 


PCS 


Proactive Command Sending 


SE 


Sending Entity 


SIM 


Subscriber Identity Module 


TIN 


Toolkit Installation Parameters 



4 Test Environment 

This clause specifies requirements that shall be met and the testing rules that shall be followed during the test 
procedure. 

4.1 Applicability 

The tests defined in the present document shall be performed taking into account the services supported by the card as 

specified in the EFsst file. 

The present document contains tests that test interoperability at the API level. The present document does not currently 
contain tests for interoperability at the SIM API framework and at the byte code level. These are for further study. 

The test defined in the present document are applicable to cards implementing GSM 03.19 [7] unless otherwise stated. 

4.2 Test environment description 

The general architecture for the test environment is: 
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GSM03.19and 
Java Card™ 2.1 
export files 



Test 
Toolkit 
Applet 



Scope of the Test Suite. 
. Elements of the Test Suite 



Applet loading 
script 



Applet 
GSM 




Applets 



Tests 
Toolkit 
Applets 



JAVACARD API 



SIM API 



TooUdt Framework 



mm 



Toolkit 
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Registry 




Handler 



GSM Framework 







Applet 
triggering 



Installer 



File System 
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NOTE: 



This diagram sliows tlie test arctiitecture required to test interoperability at botti API and bytcode level. 
The latter is currently not included in the present document. The diagram is for information. 

Figure 4.2 



4.3 



Tests format 



4.3.1 Test Area Reference 

Each test area is referenced as follows: 

API Testing:: 'API_[package name]_[classname]_[methodname]' where 
package name: 

sim. access package: '1' 

sim.toolkit package: '2' 
class name: 

yyy: 3 letters for each class. 

See Annex A for full classes acronyms list, 
method name: 

zzzz [input parameters]: 

See Annex A for full methods name acronyms list. 
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FWK: framework testing 
Chapter name: 

XXX : 3 letters for each chapter 
See annex F for full chapter acronyms list 
Subchapter name 

yyyy: : 4 letters for each subchapter 
See annex F for full subchapter acronyms list 
LDR: loader testing 
[TBD] 

4.3.1.1 Conformance requirements 

The conformance requirements are expressed in the following way: 

- Method prototype as Usted in GSM 03 . 1 9 [7] . 

- Normal execution: 

Contains normal execution and correct parameters Umit values, each referenced as a Conformance 
Requirement Reference Normal (CRRN). 

- Parameters error: 

Contains parameter errors and incorrect parameter hmit values, each referenced as a Conformance 
Requirement Reference Parameter Error (CRRP). 

- Context error: 

Contains errors due to the context the method is used in, each referenced as a Conformance Requirement 
Reference Context Error (CRRC). 

4.3.1.2 Test Area files 

The files included in the Test Area use the following naming convention: 

Test Script: [Test Area Reference]_[Test script number]. scr 

Test Applet: [Test Area Reference]_[Test applet number] .Java 

- Load Script: [Test Area Reference]_[Load Script number] .Idr 

- Cleanup Script: [Test Area Reference]_[Cleanup Script number] .clr 

- Parameter File: [Test Area Reference]_[Parameter File number] .par 

The test script, applet, installation parameters, load script, cleanup script and conversion parameters numbers start from 
1'. 

The test script, load script and cleanup script shall share a common syntax and format (see annex B). 

The parameter file has an own syntax (see annex G) and contains parameters to be used for CAP-file conversion and 
loading/cleanup script generation. 

Scripts file shall be run in the following order: 

[Test Area Reference]_l.ldr 

[Test Area Reference]_l.scr 
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[Test Area Reference]_l.clr 
[Test Area Reference]_2.1dr 
[Test Area Reference]_2.scr 
[Test Area Reference]_2.clr 

[Test Area Reference]_n.ldr 
[Test Area Reference]_n.scr 
[Test Area Reference]_n.clr 



In case that one of the files is not needed, it shall be skipped during the tests execution. 

4.3.1.3 Test Procedure 

Each test procedure contains a table to indicate the expected responses form the API and/or the APDU level as follows: 



Test Case 


Id 


Description 


API Expectation 


APDU Expectation 




Test Case detailed description 


API expected behaviour. 


Expected response at APDU 
level. 



4.3.1 .4 Test Coverage 

The table at the end of each test procedure indicates the correspondence between the Conformance Requirements 
Reference (CRR) and the different test cases. 

4.4 Initial Conditions 

The Initial Conditions are a set of general prerequisites for the SIM prior to the execution of testing. For each test 
procedure described in the present document, the following rules apply to the Initial Conditions: 

unless otherwise stated, the file system and the files' content shall fulfil the requirements described in annex C; 

- unless otherwise stated, before instalhng the applet(s) relevant to the current test procedure, all packages specific 
to other test procedures shall not be present. 

When both statements apply, a test procedure is said to be in the "Default Initial Conditions" state. 

4.5 Package name 

Java packages integrating this Test Suite shall follow this naming convention: 

sim.test.access.[Test Area Reference]: Java Card packages containing Test Area References for the GSM 03.19 

sim.access package. 

sim.test.framework.[Test Area Reference]: Java Card packages containing Test Area References for the GSM 03.19 
framework. 

sim.test.util: for the Test util package defined in this Test Suite. 

sim. test. toolkit. [Test Area Reference]: Java Card packages containing Test Area References for the GSM 03. 19 [7] 
sim.toolkit package. 

EXAMPLE: The package ../sim.test.access.[Test Area Reference] creates the following directory structure 
./sim/test/access/[Test Area Reference]/API_l_.. ._[!.. n].*, where API_l_..._[l..n].*' are the 
different test applets Java source files used in [Test Area Reference]. 
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4.6 AID Coding 

The AID coding for the Test Packages, Applet classes and Applet shall be as specified in TS 101 220 [14]. In addition, 
the following TAR values are defined for use within the present document: 

TAR Coding (3 bytes/ 24 bits): 



b1 1 b2 1 b3 1 b4 1 b5 1 b6 i :b21 | b22 | b23 | b24 



























Specific Test Applet Name 
Test Package Identifier 



Test package ldentifier( bits bl-b3): 

000 reserved (as TAR= '00.00.00' is reserved for Card Manager) 

001 API 

010 Framework 

011 Loader 
111 sim.test.util 
other values are RFU 

Application Provider specific data (1 byte): 
'00' for Package 
'01' for Applet class 
'02' for Applet Instance 

For example, the AID of Package sim.test.util is 'AO 00 00 00 09 00 02 FF FF FF FF 89 EO 00 00 00' 

4.6.1 Specific Test Applet Name for API 

Specific applet test name (bits b4-b24): 

rb4| b5| b6| b7| b8| b9 | b1 0| b1 1 1 b1 2| b1 3| b1 4| b1 5| b1 6| b1 7| b1 8| b1 9| b20| b21 1 b22| ^ 

I I Applet instance Number 

I I I I I Applet Class Number 

I I I I I I Method 

I I I I I Class 

I I API Test Package 

for API Test Package(3 bits) 
001 sim.access 
010 sim. toolkit 
other are RFU 

Class (5 bits): need to be assigned specification order see Aimex A for the full list 
Method (6 bits): need to be assigned specification order see Annex A for the full list 

Applet Class Number (5 bits): linked to Test Area, it shall start with 1 for classes and shall be for package. 

Applet Instance Number (2 bits) defined in the test procedure it shall start with 01 for applet instance and shall 
be 00 for package and class. 
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4.6.2 Specific Test Applet Name for Framework 

Specific applet test name (bits b4-b24): 

[ b4| b5| b6| b7| b8| b9 |b10|b11|b12| b13|b14|b15|b16|b17|b18|b19|b20|b21|b22^ 

I I I I I I I I I I I I I I I I I I I I "T rFU ( set to ) 

I I I Applet instance Number 

I I I I I Applet Class Number 

I I I I I I Test Area within the chapter 

I I I I Chapter 

for chapter (5 bits) 

00001 Toolkit Installation Parameters 

00010 Minimum Handler Availability 

00011 Handler Integrity 

00100 Applet Triggering 

00101 Proactive Command Sending 

00110 Framework Security 

00111 Envelope Response Posting 

01000 File System Context 

01001 Exception Handling 

01010 Other parts transferred to framework from API 
other are RFU 

Test Area within the chapter (6 bits): values are defined in Annex F 

Applet Class number (5 bits): Unked to Test Area, it shall start with 1 for classes and shall be for package. 

Applet Instance number (3 bits) defined in the test procedure it shall start with 01 for applet instance and shall be 
00 for package and class. 

4.7 Test Equipment 

These subclauses recommend a minimum specification for each of the items of test equipment referenced in the tests. 

4.7.1 APDUtool 

This test tool shall meet the following requirements: 

- be able to send command to the card TPDU; 

- be able to check none, only a part, or all of the data returned; 

- be able to check none, only part, or all of the status returned; 

- be able to accept all valid status codes returned; 

- be able to support Reader commands; 

be able to generate a log file for each test execution. 

if more data is returned than defined in the test specification, the tool shall continue; 

- if less data is returned than defined in the test specification, the tool shall aborts and return an error; 
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- if there is an error in data or status returned, the tool shall abort and return an error. 
The log file produced by the test tool shall include the following information: 

- all commands issued; 

- all data returned; 

- all status returned; 
all errors codes; 

- expected data and status in case of error; 

- comments from the scripts; 

- a log message to report success or failure of the test. 

4.7.2 Util package 

Annex D includes Java source code for the sim.test.util package as well as loading , testing and cleaning script 
examples. 

4.7.3 Applet installation parameters 
4.7.3.1 Security parameters 

Loading scripts shall use the following security parameters as stated in GSM 03.48 [8] for applet installation: 



Parameter 


Value in hexadecimal 


SPI 


OA 00 


KIC 


00 


KID 


11 


TAR 


00 00 00 


CNTR 


00 00 00 00 01 


PCNTR 


00 


Key 


01 23 45 67 89ABCD EF 



4.7.3.2 Loading components 

Cap files in loading scripts shall not include the descriptor component as described in Java Card 2.1 VM Architecture 
Specification [13]. 

4.8 Testing methodology 
4.8.1 Test interfaces and facilities 

The SIM-ME interface provides the main transport interface for the purpose of performing conformance tests. 
The SIM API interface provides the main test interface for the purpose of performing conformance tests. 

5 Test plan 

The test plan is divided according to the SIM API specification, that way the tests will follow the class hierarchy for the 
sim.toolkit and sim.access package; for the SIM Toolkit framework this test plan describes the different points that will 
be tested with the present test specification. 
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6 API Test Plan 

6.1 Package Sim. access: 
6.1.1 Interface SIMView 

NOTE: The Test applet shall be run on a class that implements this interface. 

6.1.1.1 Constants 

Test Area Reference: API_l_SVW_CONST 

6.1.1.1.1 Conformance Requirements 

This subclause does not describe the conformance requirements for a method, but rather for the constants of the 
interface. 

6.1.1.1.1.1 Normal execution 

CRRNl: The constants shall have the same name and value that is defined in GSM 03.19 [7]. 

6.1.1.1.2 Test Suite Files 
None. 

6.1.1.1.3 Test Procedure 

The constants in Java are resolved at compilation time, therefore a runtime test is not useful. No test of constants will be 
performed. 

6.1 .1 .2 Method select(short fid, byte[] fci, short fciOffset, short fciLength) 

Test Area Reference: API_1_SVW_SLCTS_BSS 
6.1.1.2.1 Conformance Requirements 

The method with the following header shall be compUant to its definition in the API. 

public short select (short fid, 
byte [ ] fci, 
short fciOffset, 
short fciLength) 
throws java . lang .NullPointerException, 

java . lang .Array IndexOutOfBoundsExcept ion, 
SIMViewException 

6.1.1.2.1.1 Normal execution 

• CRRNl : If the desired file is selected, the length of the FCI (File Control Information) which has been written to 
the array fci is returned. 

• CRRN2: If the length fciLength is greater than or equal to the length of the FCI structure, the whole FCI 
structure is copied into the array fci and the length of the FCI which has been written to the array fci is returned. 

• CRRN3: If the length fciLength is less than the length of the FCI structure, the first part of the FCI structure is 
copied into the array fci and the length of the FCI which has been written to the array fci is returned. 

• CRRN4: After selecting a DF/MF no EF is selected. 

• CRRN5: After selecting a hnear fixed EF no record is selected. 
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• CRRN6: After selecting a cyclic EF the first record which is the last updated record is selected. 

• CRRN7: The current files (file context) of any other applets shall not be changed. See GSM 03.19 [7] - 
subclause 5.2. This will be tested during the testing of the framework. 

• CRRN8: The information returned by fci shall be formatted as described in GSM 11.11 [3], subclause 9.2.1. 

• CRRN9: The file with a File-ID that matches fid shall be found according to the following selection rules: 

1) An immediate child EF or DF of the current MF/DF can be selected, 

2) A sibling DF of the current DF can be selected, 

3) The current MF/DF it self can be selected, 

4) The parent MF/DF of the current DF can be selected, 

5) The MF can always be selected. 

6.1.1.2.1.2 Parameter errors 

• CRRPl : If the array fci is null, an instance of NuUPointerException shall be thrown. 

• CRRP2: If fciOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: If fciLength is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP4: If fciOffset plus fciLength is greater than the length of the array fci. length, or fciOffset equals 
fci.length, an instance of ArraylndexOutOfBoundsException shall be thrown. 

6.1 .1 .2.1 .3 Context errors 

• CRRCl : If the file with a File-ID which matches fid could not be foimd according to the selection rules listed in 
CRRN9, an instance of SIMViewException shall be thrown. The reason code shall be 
SlMViewException.FlLE_NOT_FOUND. 

• CRRC2: If the method call causes a memory problem (e.g. memory access error), an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

• CRRC3: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 

6.1.1.2.2 Test Suite Files 

Additional requirements for the GSM personalization: None 



Test Script: 


API. 


.1. 


.svw. 


.SECTS. 


.BSS. 


.l.scr 


Test Applet: 


API. 


.1. 


.svw. 


.SECTS. 


.BSS. 


.l.java 


Load Script: 


API. 


.1. 


.svw. 


.SECTS. 


.BSS. 


.l.ldr 


Cleanup Script: 


API_ 


_1_ 


_svw_ 


.SECTS. 


_BSS_ 


_l.ck 


Parameter File: 


APL 


_1_ 


_svw_ 


_SLCTS_ 


_BSS_ 


.l.par 
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6.1.1.2.3 Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 





SIM Initialization 


Responses ignored. 




1 


Select EFICCID In MF (Transparent EF) 

fid = SIMView.FID_EF_ICCID 
byte[] fci = new byte [34] 
fciOffset = 
fciLength = 20 
select ( ) 


No exception shall be thrown. 
Shall return a value not greater 
than 20. 

<Description of fci: 

XX XX 

XX XX 

2FE2 

04 

> 




2 


Select EFicciD In MF (Transparent EF) 

fid = SIMView.FID_EF_ICCID 
fciOffset = 
fciLength = 13 
select ( ) 


No exception shall be thrown. 
Shall return 13. 

fci shall contain the first 13 bytes of 
the FCI structure. 




3 


Select DFgsm in MF 

fid — SIMView.FID DF GSM 

fciOffset = 
fciLength = 7 
select ( ) 


No exception shall be thrown. 
Shall return 7. 

fci shall contain the first 7 bytes 
of the FCI. 
<Description of fci: 

XX XX 
XX XX 
IF 20 
02 
> 




3 


Select DFgsm in MF 

fid = SIMView.FID_DF_GSM 
fciOffset = 
fciLength = 7 
select ( ) 


No exception shall be thrown. 
Shall return 7. 

fci shall contain the entire FCI 
structure. 

<Description of fci: 

XX XX 
XX XX 
IF 20 
02 
> 




4 


Select EFacm In DFgsm (CycllcEF) 

fid = SIMView.FID_EF_ACM 
fciOffset = 

J. L. -L J-iCiiy L, 11 — 

select ( ) 


No exception shall be thrown. 
Shall return a value between 15 
and 20. (Cyclic EF) 
fci shall contain the first 15 or more 
bytes of the FCI structure. 
fci[14] shall have the value 3 
(length of record). 




5 


Select MF 

fid = SIMView.FID_MF 
fciOffset = U 
fciLength = 34 
select ( ) 


No exception shall be thrown. 
Shall return a value between 22 
and 34. 

fci shall contain the entire FCI 
structure. 




6 


Select DFtelecom in MF 

fid = SIMView.FID_DF_TELECOM 
fci [0] = fci [1] = ' 05 ' 

f 1^ i Of f =^et = 9 

fciLength = 20 
select ( ) 


No exception shall be thrown. 
Shall return 20. 

fci shall contain the first 20 bytes of 
the FCI structure starting at index 
2. The first two bytes shall (still) 
have the value '05'. 




7 


Select EFfdn in DFtelecom (Linear FixedEF) 

fid = SIMView.FID_EF_FDN 

fciOffset = 
fciLength = 15 
select ( ) 


No exception shall be thrown. 
Shall return 15. 

fci shall contain the first 15 bytes of 
the FCI structure. 
fci[14] shall have the value 28 
(length of record). 




8 


fci Is null 

fid = SIMView.FID_EF_FDN 
byte[] nullBuffer = null 
fciOffset = 
fciLength = 15 
select ( ) 


Shall throw 

java.lang.NullPointerException. 
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Id 



Description 



API Expectation 



APDU Expectation 



fciOffset < 

fid = SIMView.FID_EF_FDN 

fciOffset = -1 
fciLength = 15 
select ( ) 



Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xceptlon. 



10 



fclLength < 

fid = SIMView.FID_EF_FDN 

fciOffset = 
fciLength = -1 
select ( ) 



Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 



11 



fciOffset + fciLength > fci.length 

fid = SIMView.FID_EF_FDN 
fciOffset = 20 
fciLength = 15 
select ( ) 



Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 



12 



fciOffset >= fci.length 

fid = SIMView.FID_EF_FDN 
fciOffset = 34 
fciLength = 1 
select ( ) 



Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception 



13 



1 - fid = 
fciOffset 
fciLength 

select ( ) 

2 - fid = 
select ( ) 

3 - fid = 
select ( ) 

4 - fid = 
select ( ) 

5 - fid = 
select ( ) 

6 - fid = 
select ( ) 

7 - fid = 
select ( ) 

8 - fid = 
select ( ) 

9 - fid = 
select ( ) 



Selection possibilities 

SIMView.FID_MF 
= 
= 15 

SIMView . FID_DF_TELECOM 
SIMView.FID_DF_GRAPHICS 
SIMView . FID_DF_TELECOM 
SIMView . FID_DF_GRAPHICS 
SIMView. FID_MF 
SIMView . FID_DF_GSM 
SIMView . FID_DF_TELECOM 
SIMView . FID_DF_TELECOM 



1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - No exception shall be thrown. 

5 - No exception shall be thrown. 

6 - No exception shall be thrown. 

7 - No exception shall be thrown. 

8 - No exception shall be thrown. 

9 - No exception shall be thrown. 



14 



EF not selected after lUIF/DF selection 

1 - fid = SIMView. FID_MF 
select ( ) 

fid = SIMView. FID_EF_ICCID 
select ( ) 

2 - fid = SIMView. FID_MF 
select ( ) 

readBinary ( ) 



1 - No exception shall be thrown. 

2 - Shall throw 

sim.access.SIMViewException with 
reason code NO EF SELECTED. 



15 



No selection of non-reachable file 

1 - fid = SIMView. FID_MF 
select ( ) 

2 - fid = SIMView. FID_EF_ACM 
select ( ) 



1 - No exception shall be thrown. 

2 - Shall throw 

sim.access.SIMViewException with 
reason code FILE NOT FOUND. 



16 



No record is selected after selecting linear 
fixed EF 

1 - fid = SIMView. FID_MF 

select ( ) 

2 - fid = FID_DF_SIMTEST 

select ( ) 

3 - fid = FID_EF_LARU 

select ( ) 

4 - recNumber = 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
readRecord ( ) 



1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - Shall throw 

sim.access.SIMViewException with 
reason code 

REGORD_NUMBER_NOT_AVAIL 
ABLE. 
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Id 


Description 


API Expectation 


APDU Expectation 


17 


Record pointer in selected cyclic EF 

1 - fid = SIMView.FID_MF 

select ( ) 

2 - fid = FID_DF_SIMTEST 

select ( ) 

3 - fid = FID_EF_CARU 

select ( ) 

4 - byte [ ] datal = { 1,2,3 } 
mode = REC_ACC_MODE_PREVIOUS 
updateRecord (datal ) 

5 - fid = FID_EF_CARU 
select ( ) 

readRecord (data2) 
compare datal to data2 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - No exception shall be thrown. 

5 - The contents of datal and data2 

oi idii uc iLici iiiodi. 





6.1.1.2.4 Test Coverage 



CRR Number 


Test Case Number 


N1 


1-7 


N2 


3, 5 


N3 


1,2, 4, 6,7 


N4 


14 


N5 


16 


N6 


17 


N8 


1,3 


N9 


1-7, 13 


PI 


8 


P2 


9 


P3 


10 


P4 


11,12 


CI 


15 


C2, C3 


Not Tested 



6.1.1.3 Method select (short fid) 

Test Area Reference: API_1_SVW_SLCTS. 
6.1.1.3.1 Conformance Requirements 

The method with the following header shall be compUant to its definition in the API. 

public void select (short fid) 

throws SIMViewException 

6.1.1.3.1.1 Normal execution 

• CRRNl : If the desired file is selected, no exception is thrown. 

• CRRN2: After selecting a DF/MF no EF is selected. 

• CRRN3: After selecting a Unear fixed EF no record is selected. 

• CRRN4: After selecting a cyclic EF the first record which is the last updated record is selected. 

• CRRN5: The current files (file context) of any other applets shall not be changed (GSM 03.19 [7], 
subclause 5.2). This will be tested during the testing of the framework. 

• CRRN6: The file with a File-ID that matches fid shall be found according to the following selection rules: 

1) An immediate child EF or DF of the current MF/DF can be selected; 

2) A sibling DF of the current DF can be selected; 

3) The current MF/DF it self can be selected; 
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4) 



The parent MF/DF of the current DF can be selected; 



5) 



The MF can always be selected. 



6.1.1.3.1 



2 



Parameter errors 



No requirements. 



6.1.1 



,3.1.3 



Context errors 



• CRRCl : If the file with a File-ID which matches fid could not be foimd according to the selection rules listed in 
CCRN6, an instance of SIMViewException shall be thrown. The reason code shall be 
SlMViewException.FlLE_NOT_FOUND. 

• CRRC2: If the method call causes a memory problem (e.g. memory access error), an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

• CRRC3: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 



6.1.1.3.2 Test Suite Files 

Additional requirements for the GSM personalization: None 



Test Script: 


API. 


.1. 


.svw. 


.SECTS. 


.l.scr 


Test Applet: 


API. 


.1. 


.svw. 


.SECTS. 


.l.java 


Load Script: 


API. 


.1. 


.svw. 


.SECTS. 


.Lldr 


Cleanup Script: 


API_ 


_1_ 


_svw_ 


.SECTS. 


.l.ck 


Parameter File: 


AP1_ 


_1_ 


_svw_ 


.SECTS. 


.l.par 
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6.1.1.3.3 



Test Procedure 



Id 



Description 



API Expectation 



APDU Expectation 



SIM Initialization 



Responses ignored. 



Select EFjcciD in MF (Transparent EF) 

fid = SIMView.FID_EF_ICCID 

select ( ) 



No exception shall be thrown. 



EF not selected after MF/DF selection 

1 - fid = SIMView.FID_MF 
select ( ) 

fid = SIMView.FID_EF_ICCID 
select ( ) 

2 - fid = SIMView.FID_MF 
select ( ) 

readBinary ( ) 



1 - No exception shall be thrown. 

2 - Shall throw 

sim.access.SIMViewException with 
reason code NO EF SELECTED. 



No record is selected after selecting linear 
fixed EF 

1 - fid = SIMView.FID_MF 
select ( ) 

2 - fid = FID_DF_SIMTEST 
select ( ) 

3 - fid =FID_EF_LARU 
select ( ) 

4 - recNumber = 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

readRecord ( ) 



1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - Shall throw 

sim.access.SIMViewException with 
reason code 

RECORD_NUMBER_NOT_AVAIL 
ABLE. 



Record pointer in selected cyclic EF 

1 - fid = SIMView.FID_MF 
select { ) 

2 - fid =FID_DF_SIMTEST 
select ( ) 

3 - fid = FID_EF_CARU 
select ( ) 

4 - byte[] datal = { 1,2,3 } 
updateRecord (datal ) 

5 - fid = FID_EF_CARU 
select ( ) 

readRecord (data2 ) 
compare datal to data2 



1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - No exception shall be thrown. 

5 - The contents of datal and data2 
shall be identical. 



Selection possibilities 



1 - fid = 


SIMView 


FID. 


_MF 




select ( ) 










2 - fid = 


SIMView 


FID. 


_DF. 


.TELECOM 


select ( ) 










3 - fid = 


SIMView 


FID. 


_DF. 


.GRAPHICS 


select ( ) 










4 - fid = 


SIMView 


FID. 


_DF. 


.TELECOM 


select ( ) 










5 - fid = 


SIMView 


FID. 


_DF_ 


.GRAPHICS 


select ( ) 










6 - fid = 


SIMView 


FID. 


_MF 




select ( ) 










7 - fid = 


SIMView 


FID. 


_DF_ 


.GSM 


select ( ) 










8 - fid = 


SIMView 


FID. 


_DF_ 


.TELECOM 


select ( ) 










9 - fid = 


SIMView 


FID. 


_DF_ 


.TELECOM 


select ( ) 











1 - No exception 

2 - No exception 

3 - No exception 

4 - No exception 

5 - No exception 

6 - No exception 

7 - No exception 

8 - No exception 

9 - No exception 



shall be 
shall be 
shall be 
shall be 
shall be 
shall be 
shall be 
shall be 
shall be 



thrown, 
thrown, 
thrown, 
thrown, 
thrown, 
thrown, 
thrown, 
thrown, 
thrown. 



No 

1 - fid = 
select ( ) 

2 - fid = 
select ( ) 



selection of unreachable file 

SIMView. FID_MF 
SIMView. FID EF ACM 



1 - No exception shall be thrown. 

2 - Shall throw 

sim.access.SIMViewException with 
reason code FILE NOT FOUND. 
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CRR Number 


Test Case Number 


N1 


1 


N2 


2 


N3 


3 


N4 


4 


N6 


5 


C1 


6 


C2, C3 


Not Tested 



6.1.1.4 Method status 

Test Area Reference: API_1_SVW_STAT_BSS. 

6.1.1.4.1 Conformance Requirements 

The method with the following header shall be comphant to its definition in the API. 

public short status (byte [ ] fci, 

short fciOffset, 
short fciLength) 
throws java . lang .NullPointerException, 

java . lang .Ar ray IndexOutOfBoundsExcept ion, 
SIMViewException 

6.1.1.4.1.1 Normal execution 

• CRRNl : The FCI (File Control Information) of the current DF (or MF) is returned in the same format as for a 
SELECT conmiand in case of selecting an MF/DF (described in GSM 03.19 [7], subclause 9.2.1). 

• CRRN2: If the length fciLength is greater than or equal to the length of the FCI structure, the whole FCI 
structure is copied into the array fci and the length of the FCI which has been written to the array fci is returned. 

• CRRN3: If the length fciLength is less than the length of the FCI structure, the first part of the FCI structure is 
copied into the array fci and the length of the FCI which has been written to the array fci is returned. 

6.1.1.4.1.2 Parameter errors 

• CRRPl : If the array fci is null, an instance of NullPointerException shall be thrown. 

• CRRP2: If fciOffset is less than 0, an instance of ArraylndexOutOfBoundsExceplion shall be thrown. 

• CRRP3: If fciLength is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP4: If fciOffset plus fciLength is greater than the length of the array fci.length, or fciOffset equals 
fci.length, an instance of ArraylndexOutOfBoundsException shall be thrown. 

6.1 .1 .4.1 .3 Context errors 

• CRRCl: If the method call causes a memory problem (e.g. memory access error), an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

• CRRC2: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.lNTERNAL_ERROR. 

6.1.1.4.2 Test Suite Files 

Additional requirements for the GSM personalization: 

Test Script: API_l_SVW_STAT_BSS_l.scr 
Test Applet: AP1_1_S VW_STAT_BSS_1 .java 
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Load Script: 
Cleanup Script: 
Parameter File: 

6.1.1.4.3 



API_1_SVW_STAT_BSS_1 .Idr 
API_1_SVW_STAT_BSS_1 .clr 
API_1_SVW_STAT_BSS_1 .par 

Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 





SIM Initialization 


Responses ignored. 




1 


Status of IMF 

byte [ ] fci ^ new byte [34] 
fciOffset = 
fciLength = 7 
status ( ) 


No exception sliall be thrown. 
Shall return 7. 

fci shall contain the entire FCI 
<?trijctijrp 

oil i#IWLL#ll w- 

<Description of fci: 

XX XX 

XX XX 

3F 00 

01 

> 




2 


Status after select EFiccid in MR 

1 - fid = SIMView.FID_DF_GSM 
fciOffset = 

fciLength = 34 
len = select ( ) 

2 - byte[] fci2 = new byte [34] 

xenz — status \ ) 

3 - Compare len and len2 

4 - Compare tlie len bytes of fci and fci2 


1 - No exception shall be thrown. 
Shall return a value between 22 
and 34. 

2 - No exception shall be thrown. 
Shall return 22 or more. 

3 - len and Ien2 shall be identical 

4 - fci and fci2 shall be identical 

Iwl Ciil Iw Iwl^ Ol lull Iwlwl ILIwdil 




3 


Status of DFTelecom 

1 - fid = SIMView.FID_DF_TELECOM 
select ( ) 

2 - fciOffset = 
fciLengtli = 100 
status ( ) 


1 - No exception shall be thrown. 
Shall return a value between 22 
and 34. 

2 - No exception shall be thrown. 
Shall return a value between 22 
and34. 

fci shall contain the entire FCI 

structure (check that returned value 
is equal to 13 plus the "length of 

£11 ixM £ ' r M \ i~~ 1 |~N _ f ■ 1 ■ ■ 

following data - fci[12]).FID of the 
returned fci (fci[4:5]) is 
FID_DF_TELECOM. 




4 


Status DFtelecom 

fciOffset = 
fciLength = 7 
status ( ) 


No exception shall be thrown. 

Shall return 7. 

fci shall contain the first 7 bytes of 
thp FCI *5triirtiirp <;tartinn at indpx 
0. 

FID of the returned fci (fci[4:5]) is 
FID DF TELECOM. 




5 


fci is null 

byte[] nullBuffer = null 
fciOffset = 
fciLength = 34 
status ( ) 


Shall throw 

java.lang.NullPointerException. 




6 


fciOffset < 

fciOffset = -1 
fciLength = 34 
status ( ) 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 




7 


fciLength < 

fciOffset = 
fciLength = -1 
status ( ) 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 




8 


fciOffset + fciLength > fci.length 

fciOffset = 20 
fciLength = 15 
status ( ) 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 




9 


fciOffset >= fci.length 

fciOffset = 34 
fciLength = 1 
status ( ) 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 
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6.1 .1 .4.4 Test Coverage 



CRR Number 


Test Case Number 


N1 


1-4 


N2 


2, 3 


N3 


1,4 


PI 


5 


P2 


6 


P3 


7 


P4 


8, 9 


CI, C2 


Not Tested 



6.1.1.5 Method readBinary 

Test Area Reference: API_1_SVW_REDBS_BSS. 
6.1.1.5.1 Conformance Requirements 

The method with the following header shall be comphant to its definition in the APT 

public short readBinary ( short fileOffset, 

byte [ ] resp, 
short respOffset, 
short respLength) 
throws java . lang .NullPointerException, 

java . lang .Array IndexOutOfBoundsExcept ion, 
SIMViewException 

6.1.1.5.1.1 Normal execution 

• CRRNl: If data can be accessed at the specified offset, the value respOffset plus respLength are returned and the 
data bytes of the currently selected transparent file are returned in resp. 

6.1.1.5.1.2 Parameter errors 

• CRRPl : If fileOffset is less than 0, an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.OUT_OF_FILE_BOUNDARIES. 

• CRRP2: If fileOffset plus respLength exceeds the length of the file, an instance of SIMViewException shall be 
thrown. The reason code shall be SIMViewException.OUT_OF_FILE_BOUNDARIES. 

• CRRP3: If the array resp is null, an instance of NullPointerException shall be thrown. 

• CRRP4: If respOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP5: If respLength is less than 0, an instance of ArraylndexOutOfBovmdsException shall be thrown. 

• CRRP6: If respOffset plus respLength is greater than the length of the array resp.length, an instance of 
ArraylndexOutOfBoundsException shall be thrown. 

6.1.1.5.1.3 Context errors 

• CRRCl: If the calhng applet has currently no EF selected, an instance of SIMViewException shall be thrown. 
The reason code shall be SIMViewException.NO_EF_SELECTED. 

• CRRC2: If the currently selected EF is not transparent, an instance of SIMViewException shall be thrown. The 
reason code shall be SIMViewException.FTLEJNCONSISTENT. 

• CRRC3: If the calhng applet does not fulfil the access condition, READ, to perform this function, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.AC_NOT_FULFILLED. 
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• CRRC4: If the currently selected EF is invalidated and the file status of the EF does not allow for the reading of 
an invalidated file, an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.INVALIDATION_STATUS_CONTRADICTION. 

• CRRC5: If the method call causes a memory problem (e.g. memory access error), an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

• CRRC6: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 



6.1.1.5.2 Test Suite Files 

Additional requirements for the GSM personalization: none. 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.1.1.5.3 



API_1_S VW_REDBS_BSS_1 .scr 
API_1_SVW_REDBS_BSS_1 .java 
API_1_SVW_REDBS_BSS_1 .Idr 
API_1_SVW_REDBS_BSS_1 .ck 
API_1_SVW_REDBS_BSS_1 .par 

Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 





SIM Initialization 


Responses Ignored 




1 


Read from EFICCID In MF (Transparent EF) 

1 - fid = SIMView.FID_EF_ICCID 

select ( ) 

2 - fileOffset = 

byte [ ] resp = new byte [20] 
resp[0:19] = '55' 
respOffset ^ 10 
respLength = 10 
readBinary ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 
Shall return 20. 

resp shall contain the entire 
contents of EFICCID starting at 
index 1 0. 

<Description of resp: 

55 55 55 55 55 55 55 55 55 55 

OF FF FF FF FF FF FF FF FF FF 

> 




2 


Read from EFICCID in MF 

resp[0:19] = '55' 
fileOffset = 5 
respOffset = 10 
respLength = 5 
readBinary ( ) 


No exception shall be thrown. 
Shall return 15. 

resp shall contain the last 5 bytes 

of EFICCID starting at Index 10. 

<Descrlptlon of resp: 

55 55 55 55 55 55 55 55 55 55 

FF FF FF FF FF 55 55 55 55 55 

> 




3 


Offset into File out of bounds 

fileOffset = -1 
respOffset = 
respLength = 10 
readBinary ( ) 


Shall throw 

sIm. access. SIMViewException with 
reason code 

OUT_OF_FILE_BOUNDARIES. 




4 


fileOffset + respLength > EF length 

fileOffset = 9 
respOffset ^ 
respLength = 2 
readBinary ( ) 


Shall throw 

sIm. access. SIMViewException with 
reason code 

OUT_OF_FILE_BOUNDARIES. 




5 


resp is null 

byte[] nullBuffer = null 
fileOffset = 
respOffset = 
respLength = 10 
readBinary ( ) 


Shall throw 

java.lang.NullPointerException. 




6 


respOffset < 

fileOffset = 
respOffset = -1 
respLength = 10 
readBinary ( ) 


Shall throw 
java.lang. 

ArraylndexOutOfBoundsException. 
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Id 


Description 


API Expectation 


APDU Expectation 


7 


respLength < 

fileOffset = 
respOffset = 
respLength = -1 
readBinary ( ) 


Shall throw 
java.lang. 

ArraylndexOutOfBoundsException. 




8 


respOffset + respLength > resp.length 

fileOffset = 
respOffset = 10 
respLength = 11 
readBinary ( ) 


Shall throw 
java.lang. 

ArraylndexOutOfBoundsException. 




9 


EF is not Transparent 

1 - fid = FID_DF_SIMTEST 
select ( ) 

2 - fid = FID_EF_LARU 
select ( ) 

3 - fileOffset = 
respOffset = 
respLength = 1 
readBinary ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - Shall throw 

sim. access. SIMViewException with 
reason code 
FILEJNCONSISTENT. 




10 


Access condition not fuifiiied 

1 - fid = DFSIMTTEST 
select ( ) 

2 - fid = EFTNR 
select ( ) 

3 - fileOffset = 
respOffset = 
respLength = 1 
readBinary ( ) 


Shall throw 

sim. access. SIMViewException with 
reason code 
AC_NOT_FULFILLED. 




11 


EF is invalidated 

1 - fid = EFTNU 
invalidate ( ) 

2 - readBinary 

3 - rehabilitate ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code 

INVALIDATION STATUS CONTR 
ADICTION. 

3 - No exception shall be thrown. 




12 


No EF selected 

1- fid = SIMView.FID_MF 

select ( ) 

2 readBinary 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code NO EF SELECTED. 





6.1 .1 .5.4 Test Coverage 



CRR Number 


Test Case Number 


N1 


1-2 


PI 


3 


P2 


4 


P3 


5 


P4 


6 


P5 


7 


P6 


8, 


CI 


12 


C2 


9 


C3 


10 


C4 


11 


C5, C6 


Not Tested 



6.1 .1 .6 Method updateBinary 

Test Area Reference: API_1_SVW_UPDBS_BSS. 
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6.1.1.6.1 



Conformance Requirements 



The method with the following header shall be comphant to its definition in the API. 



public void updateBinary ( short fileOffset, 

byte[] data. 



short dataOffset, 
short dataLength) 



throws java . lang . NullPointerExcept ion, 

java . lang .Array IndexOutOfBoundsExcept ion, 
S IMViewExcept ion 



6.1.1 



6.1.1 



Normal execution 



• CRRNl: The currently selected transparent file is updated starting at fileOffset, with the string of dataLength 
bytes in the array data starting at dataOffset. 



• CRRPl: If fileOffset is less than 0. an instance of SlMViewException shall be thrown. The reason code shall be 
SIMViewException.OUT_OF_FlLE_BOUNDARlES. 

• CRRP2: If fileOffset plus dataLength exceeds the length of the file, an instance of SlMViewException shall be 
thrown. The reason code shall be SlMViewException.OUT_OF_FlLE_BOUND ARIES. 

• CRRP3: If the array data is null, an instance of NuUPointerException shall be thrown. 

• CRRP4: If dataOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP5: If dataLength is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP6: If dataOffset plus dataLength greater than the length of the array data.length an instance of 
ArraylndexOutOfBoundsException shall be thrown. 

6.1 .1 .6.1 .3 Context errors 

• CRRCl: If the calling applet has ciurently no EE selected, an instance of SlMViewException shall be thrown. 
The reason code shall be SIMViewException.NO_EF_SELECTED. 

• CRRC2: If the currently selected EE is not transparent, an instance of SlMViewException shall be thrown. The 
reason code shall be SIMViewException.FILEJNCONSISTENT. 

• CRRC3: If the calling applet does not fulfil the access condition, UPDATE, to perform this function, an instance 
of SlMViewException shall be thrown. The reason code shall be SIMViewException.AC_NOT_FULFILLED. 

• CRRC4: If the currently selected EE is invalidated and the file status of the EE does not allow for updating of an 
invalidated file, an instance of SlMViewException shall be thrown. The reason code shall be 
SIMViewException.INVALIDATION_STATUS_CONTRADICTION. 

• CRRC5: If the method call causes a memory problem (e.g. memory access error), an instance of 
SlMViewException shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

• CRRC6: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SlMViewException shaU be thrown. The reason code shaU be SIMViewException.INTERNAL_ERROR. 

6.1.1.6.2 Test Suite Files 

Additional requirements for the GSM personalization: None 
Test Script: APl_l_SVW_UPDBS_BSS_l.scr 
Test Applet: API_1_SVW_UPDBS_BSS_1 .java 

Load Script: API_l_SVW_UPDBS_BSS_l.ldr 



6.1.1 



,6.1.2 



Parameter errors 
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Cleanup Script: API_l_SVW_UPDBS_BSS_l.clr 
Parameter File: API_l_SVW_UPDBS_BSS_l.par 



6.1.1.6.3 Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 





SIM Initialization 


Responses ignored. 




1 


No EF selected 

fileOffset = 
byte[] data = new byte [20] 
data[0] = '55' 
dataOffset = 
dataLength = 10 
updateBinary ( ) 


Shall throw 

sim.access.SIMViewException with 
reason code NO_EF_SELECTED. 




2 


Update Transparent EF 

1 - fid = DFSIMTEST 

select ( ) 

2 - fid = EFTARU 

select { ) 

3 - fileOffset = 3 
data[0] = '55' 
dataOffset = 
dataLength = 1 
updateBinary ( ) 

4 - fileOffset = 3 
respOffset = 
respLength = 1 
readBinary ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - No exception shall be thrown. 
Data in resp[0] shall be '55'. 




3 


1 - fileOffset = 254 

data[0] = '55' 
data[l] = 'AA' 
data[2] = '66' 
dataOffset = 
dataLength = 3 
updateBinary () 
2 - fileOffset = 254 
respOffset = 
respLength = 3 
readBinary { ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 
Data in resp shall be 

resp[0] = '55' 
resp[1 ] = 'AA' 
respL^ij = oo 




4 


Offset into File out of bounds 

fileOffset = -1 
dataOffset = 
dataLength = 10 
updateBinary ( ) 


Shall throw 

sim.access.SIMViewException with 
reason code 

OUT_OF_FILE_BOUNDARIES. 




5 


fileOffset + dataLength > EF length 

fileOffset = 259 
dataOffset = 
dataLength = 2 
updateBinary ( ) 


Shall throw 

sim.access.SIMViewException with 
reason code 

OUT_OF_FILE_BOUNDARIES. 




6 


data is null 

byte [ ] nullBuffer = null 
fileOffset = 
dataOffset = 
dataLength =10 
updateBinary ( ) 


Shall throw 

java.lang.NullPointerException. 




7 


dataOffset < 

fileOffset = 

dataOffset = -1 
dataLength =10 
updateBinary ( ) 


Shall throw 
java.lang. 

ArraylndexOutOfBoundsException. 




8 


dataLength < 

fileOffset = 
dataOffset = 
dataLength = -1 
updateBinary ( ) 


Shall throw 
java.lang. 

ArraylndexOutOfBoundsException. 




9 


dataOffset + dataLength > data.length 

fileOffset = 
dataOffset = 10 
dataLength = 11 
updateBinary ( ) 


Shall throw 
java.lang. 

ArraylndexOutOfBoundsException. 
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Id 


Description 


API Expectation 


APDU Expectation 


10 


EF is not Transparent 

1 - fid = FID_DF_SIMTEST 

select ( ) 

2 - fid = FID_EF_LARU 

select ( ) 

3 - fileOffset = 
data[0] = '55' 
dataOffset = 
dataLength = 1 
updateBinary { ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - Shall throw 

sim.access.SIMViewException with 
reason code 
FILEJNCONSISTENT. 




11 


Access condition not fulfilled 

1 - fid = DFSIMTEST 

select ( ) 
fid = EFTNU 
select ( ) 

2 - fileOffset = 
data[0] = '55' 
dataOffset = 
dataLength = 1 
updateBinary ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim.access.SIMViewException with 
reason code 
AC_NOT_FULFILLED. 




12 


EF Is Invalidated 

1 - fid = EFTNR 
invalidate ( ) 

2 - fileOffset = 
data[0] = '55' 
dataOffset = 
dataLength = 1 
updateBinary ( ) 

3 - rehabilitate ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim.access.SIMViewException with 
reason code 

INVALIDATION STATUS CONTR 
ADICTION. 

3 - No exception shall be thrown. 





6.1 .1 .6.4 Test Coverage 



CRR Number 


Test Case Number 


N1 


2, 3 


PI 


4 


P2 


5 


P3 


6 


P4 


7 


P5 


8 


P6 


9 


CI 


1 


C2 


10 


C3 


11 


C4 


12 


C5, C6 


Not Tested 



6.1 .1 .7 Method read Record 

Test Area Reference: API_1_SVW_REDRSBS_BSS. 
6.1.1.7.1 Conformance Requirements 

The method with the following header shall be compUant to its definition in the API. 

public short readRecord ( short recNumber, 

byte mode, 
short recOffset, 
byte [ ] resp, 
short respOffset, 
short respLength) 
throws java . lang .NullPointerException, 

java . lang .Array IndexOutOfBoundsExcept ion, 
S IMViewExcept ion 
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6.1.1.7.1.1 Normal execution 

• CRRNl: The data bytes from the record, specified by mode and recNumber of the currently selected linear fixed 
or cyclic EF, is read at recOffset. A total of respLength bytes of this data is copied to the array resp at respOffset. 

• CRRN2: If the access mode is REC_ACC_MODE_ABSOLUTE_CURRENT: 

- if recNumber is not 0, the record addressed by recNumber will be read; 

- if recNumber is the current selected record will be read; and 

- the current record pointer shall not change. 

• CRRN3: If the access mode is REC_ACC_MODE_NEXT: 

- the next record relative to the current selected record will be selected and read; 

- if no current record is selected, the first record will be selected and read; 

- if the current record pointer is set to the last record for a cyclic EF the record pointer is set to the first record 
and the record is read; 

- the current record pointer of any other applet shall not be changed. 

• CRRN4: If the access mode is REC_ACC_MODE_PREVIOUS: 

- the previous record relative to the current selected record will be selected and read; 

- if no current record is selected, the last record will be selected and read; 

- if the current record pointer is set to the first record, for a linear fixed EF the method responses with an error 
exception and for a cyclic EF the record pointer is set to the last record and the record is read; 

- the current record pointer of any other applet shall not be changed. 

6.1.1.7.1.2 Parameter errors 

• CRRPl: If the currently selected EF is hnear fixed and the access mode is 
REC_ACC_MODE_ABSOLUTE_CURRENT and recNumber is less than or greater than records available, an 

instance of SlMViewException shall be thrown. The reason code shall be 
SlMViewException.RECORD_NUMBER_NOT_AVAlLABLE. 

• CRRP2: If the currently selected EF is hnear fixed and the access mode is 
REC_ACC_MODE_ABSOLUTE_CURRENT, recNumber is and there is no current record selected, an 
instance of SlMViewException shall be thrown. The reason code shall be 
SIMViewException.RECORD_NUMBER_NOT_AVAILABLE. 

• CRRP3: If the currently selected EF is linear fixed and the access mode is REC_ACC_MODE_NEXT and the 
current record pointer is set to the last record, an instance of SlMViewException shall be thrown. The reason 
code shall be SIMViewException.RECORD_NUMBER_NOT_AVAILABLE. 

• CRRP4: If the currently selected EF is linear fixed and the access mode is REC_ACC_MODE_PREVIOUS and 

the current record pointer is set to the first record, an instance of SlMViewException shall be thrown. The reason 
code shall be SlMViewException.RECORD_NUMBER_NOT_AVAlLABLE. 

• CRRP5: If the specified offset into the selected record recOffset is less than 0, an instance of SlMViewException 
shall be thrown. The reason code shall be SIMViewException.OUT_OF_RECORD_BOUND ARIES. 

• CRRP6: If recOffset plus respLength is greater than the record length, an instance of SlMViewException shall 
be thrown. The reason code shall be SIMViewException.OUT_OF_RECORD_BOUNDARIES. 

• CRRP7: If the access mode is not between 2 and 4 inclusive (2 = REC_ACC_MODE_NEXT, etc.), an instance 
of SlMViewException shall be thrown. The reason code shall be SIMViewException.INVALID_MODE. 

• CRRP8: If the array resp is null, an instance of NuUPointerException shall be thrown. 
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• CRRP9: If respOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRPIO: If respLength is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRPl 1 : If respOffset plus respLength is greater than the length of the array resp.length, or respOffset equals 
resp.length, an instance of ArraylndexOutOfBoundsException shall be thrown. 

6.1 .1 .7.1 .3 Context errors 

• CRRCl : If the calhng applet has currently no EF selected, an instance of SIMViewException shall be thrown. 
The reason code shall be SIMViewException.NO_EF_SELECTED. 

• CRRC2: If the currently selected EF is neither Unear fixed nor cyclic, an instance of SIMViewException shall be 
thrown. The reason code shall be SIMViewException.FILEJNCONSISTENT. 

• CRRC3: If the calhng applet does not fulfil the access condition, READ, to perform this function, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.AC_NOT_FULFILLED. 

• CRRC4: If the currently selected EF is invalidated and the file status of the EF does not allow for reading an 
invalidated file, an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.INVALIDATION_STATUS_CONTRADICTION. 

• CRRC5: If the method call causes a memory problem (e.g. memory access error), an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

• CRRC6: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 

6.1.1.7.2 Test Suite Files 



Additional requirements for the GSM personalization: None 



Test Script: 


API. 


.1. 


.SVW. 


.REDRSBS. 


.BSS. 


.l.scr 


Test Applet: 


API. 


.1. 


.SVW. 


.REDRSBS. 


.BSS. 


.l.java 


Load Script: 


API. 


.1. 


.SVW. 


.REDRSBS. 


.BSS. 


.l.ldr 


Cleanup Script: 


API. 


.1. 


.SVW. 


.REDRSBS. 


.BSS. 


.l.ch 


Parameter File: 


API. 


.1. 


-SVW. 


.REDRSBS. 


.BSS. 


.l.par 



6.1.1.7.3 Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 





SIM Initialization 


Responses ignored. 




1 


No EF selected 

recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

recOffset = 

byte[] resp = new byte [20] 
respOffset = 
respLength = 10 
readRecord ( ) 


Shall throw 

sim. access. SIMViewException with 
reason code NO_EF_SELECTED. 
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Id 


Description 


API Expectation 


APDU Expectation 


2 


Read Absolute and Current from Linear Fixed 
EF 

1 - fid = DFSIMTEST 
select ( ) 

2 - fid = EFLARU 
select ( ) 

/ / Record pointer not set . 

3 - recNumber = 

mode = REC_ACC_MODE_NEXT 

recOffset = 
respOffset = 
respLength = 4 
readRecord ( ) 

4 - recNumber = 2 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

readRecord ( ) 

5 - recNumber = 1 
readRecord ( ) 

6 - recNumber = 

resp[0] = resp[l] = resp[2] = resp[3] = 
'00' 

readRecoiTci ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown, 
resp shall be: 

resp[0] = '55' 
resp[1] = '55' 
resp[2] = '55' 
resp[3] = '55' 

4 - No exception shall be thrown, 
resp shall be: 

resp[0] = 'AA' 
resp[1] = 'AA' 
resp[2] = 'AA' 
resp[3] = 'AA' 

5 - No exception shall be thrown, 
resp shall be: 

resp[0] = '55' 
resp[1] = '55' 
resp[2] = '55' 
resp[3] = '55' 

6 - No exception shall be thrown, 
resp shall be: 

resp[0] = '55' 
resp[1] = '55' 
resp[2] = '55' 
resp[3] = '55' 




3 


Read Next from Linear Fixed EF 

recNumber = 
mode = REC_ACC_MODE_NEXT 
recOffset = 
respOffset = 
respLength = 4 
readRecord ( ) 


No exception shall be thrown. 

resp shall be: 

resp[0] = 'AA' 

resp[1] = 'AA' 

resp[2] = 'AA' 

resp[3] = 'AA' 




4 


Read Next from Linear Fixed EF 

recNumber = 
mode = REC_ACC_MODE_NEXT 
recOffset = 
respOffset = 
respLength = 4 
readRecord ( ) 


Shall throw 

sim. access. SIMViewException with 
reason code 

RECORD NUMBER NOT AVAIL 
ABLE. 




5 


Read Previous from Linear Fixed EF 

recNumber = 

mode = REC_ACC_MODE_PREVIOUS 
recOffset = 
respOffset = 
respLength = 4 
readRecord ( ) 


No exception shall be thrown. 

resp shall be: 

resp[0] = '55' 

resp[1] = '55' 

resp[2] = '55' 

resp[3] = '55' 




6 


Read Previous from Linear Fixed EF 

recNumber = 

mode = REC_ACC_MODE_PREVIOUS 
recOffset = 
respOffset = 
respLength = 4 
readRecord ( ) 


Shall throw 

sim. access. SIMViewException with 
reason code 

RECORD NUMBER NOT AVAIL 
ABLE. 
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Id 


Description 


API Expectation 


APDU Expectation 


7 


Read Absolute and Current from Cyclic EF 

1 - fid = EFCARU 

select ( ) 

2 - recNumber = 2 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

recOffset = 
respOffset = 
respLength = 3 
readRecord ( ) 

3 - recNumber = 1 
readRecord ( ) 

4 - recNumber = 

resp[0] = resp[l] = resp[2] = '00 
readRecord ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown, 
resp shall be: 

resp[0] = ' AA' 
resp[1] = 'AA' 
resp[2] = ' AA' 

3 - No exception shall be thrown. 

resp shall be: 
resp[0] = '55' 
resp[1] = '55' 
resp[2] = '55' 

4 - No exception shall be thrown, 
resp shall be: 

resp[0] = '55' 
resp[1] = '55' 
resp[£:j = 00 




8 


Read Next from Cyclic EF 

recNumber = 
mode = REC_ACC_MODE_NEXT 
recOffset = 
respOffset = 
respLength = 3 
readRecord ( ) 


No exception shall be thrown, 
resp shall be: 
resp[0] = 'AA' 
resp[1] = 'AA' 
resp[2] = 'AA' 




9 


Read Next from Cyclic EF 

recNumber = 
mode = REC_ACC_MODE_NEXT 
recOffset = 
respOffset = 
respLength = 3 
readRecord ( ) 


No exception shall be thrown. 

resp shall be: 
resp[0] = '55' 
resp[1] = '55' 
resp[2] = '55' 




10 


Read Previous from Cyclic EF 

recNumber = 

mode = REC_ACC_MODE_PREVIOUS 

recOffset = 
respOffset = 
respLength = 3 
readRecord ( ) 


No exception shall be thrown, 
resp shall be: 
resp[0] = 'AA' 
resp[1] = 'AA' 
resp[2] = 'AA' 




11 


Read Previous from Cyclic EF 

recNumber = 

mode = REC_ACC_MODE_PREVIOUS 

recOffset = 
respOffset = 
respLength = 3 
readRecord ( ) 


No exception shall be thrown, 
resp shall be: 
resp[0] = '55' 
resp[1] = '55' 
resp[2] = '55' 




12 


Read Absolute from Linear Fixed EF beyond 

Records 

1 - fid = EFLARU 
select ( ) 

2 — recNumber = —1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
recOffset = 
respOffset = 
respLength = 4 
readRecord ( ) 

3 - recNumber = 3 
readRecord ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim.access.SIMViewException with 
reason code 

RECORD NUMBER NOT AVAIL 
ABLE. 

3 - Shall throw 

sim.access.SIMViewException with 
reason code 

RECORD NUMBER NOT AVAIL 
ABLE. 




13 


No current record in linear fixed EF, read 

current 

1 - fid = EFLARU 

select //No curr rec 

2 - recNumber =0 // curr rec 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
recOffset = 
respOffset = 
respLength = 4 
readRecord ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim.access.SIMViewException with 
reason code 

RECORD NUMBER NOT AVAIL 
ABLE. 
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Id 


Description 


API Expectation 


APDU Expectation 


14 


recOffset < 

1 - fid = EFLARU 

select ( ) 

2 - recNumber =1 // rec 1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
recOffset = -1 
respOffset = 
respLength = 4 
readRecord ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code 

OUT OF RECORD BOUNDARIE 
S. 




15 


recOffset + respLength > Record Length 

1 - fid = EFLARU 
select ( ) 

2 - recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
recOffset = 2 
respOffset = 
respLength = 4 
readRecord ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim.access.SIMViewException with 
reason code 

OUT OF RECORD BOUNDARIE 
S. 




16 


Reading with Invalid mode 

1 - fid = EFLARU 
select ( ) 

2 - recNumber = 
mode = 1 
recOffset = 
respOffset = 
respLength = 4 
readRecord ( ) 

3 — mode = 5 
readRecord ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim.access.SIMViewException with 
reason code INVALID_MODE. 

3 - Shall throw 

sim.access.SIMViewException with 
reason code INVALID_MODE. 




17 


resp Is null 

byte[] nullBuffer = null 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

respOffset = 
respLength = 10 
readRecord ( ) 


Shall throw 

java.lang.NullPointerException. 




18 


respOffset < 

respOffset = -1 
respLength = 10 
readRecord () 


Shall throw 
java.lang. 

ArraylndexOutOfBoundsException. 






respLengin < u 

respOffset = 
respLength = -1 
readRecord () 


onaii Tnrow 
java.lang. 

ArraylndexOutOfBoundsException. 




20 


respOffset + respLength > resp.length 

respOffset = 10 
respLength = 11 
readRecord () 


Shall throw 
java.lang. 

ArraylndexOutOfBoundsException. 




21 


EF Is neither Cyclic nor Linear Fixed 

1 - fid = DFSIMTEST 
sslsct ( ) 

2 - fid = EFTNU 
select ( ) 

3 - respOffset = 
respLength = 4 
readRecord ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - Shall throw 

sim.access.SIMViewException with 
reason code 
FILE_INCONSISTENT. 




22 


Access condition not fulfilled 

1 - fid = EFCNR 


1 - No exception shall be thrown. 

2 - Shall throw 






select ( ) 

2 - respLength = 3 
readRecord ( ) 


sim.access.SIMViewException with 
reason code 






AC NOT FULFILLED. 




23 


EF Is Invalidated 

1 - fid = EFCNU 
invalidate ( ) 

2 - readRecord () 

3 - rehabilitate ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim.access.SIMViewException with 
reason code 

INVALIDATION STATUS CONTR 
ADICTION. 

3 - No exception shall be thrown. 
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6.1 .1 .7.4 Test Coverage 



HRR Niirnhpf 


Tp^t r^fl^p Niimhpr 


N1 

IM 1 






9 7 




T 8 q 


N4 


s in 1 1 

O, 1 U, 1 1 


PI 


12 




1 o 


r o 


A 
t 


P4 

n t 


c 

D 


P^i 


14 


PR 


1 o 


P7 


1 o 


P8 


17 


P9 


18 


P10 


19 


P11 


20 


CI 


1 


C2 


21 


C3 


22 


C4 


23 


C5, C6 


Not Tested 



6.1.1.8 Method updateRecord 

Test Area Reference: API_1_SVW_UPDRSBS_BSS. 
6.1.1.8.1 Conformance Requirements 

The method with the following header shall be comphant to its definition in the API. 

public void updateRecord ( short recNumber, 

byte mode, 
short recOffset, 
byte[] data, 
short dataOffset, 
short dataLength) 
throws java , lang . NullPointerException, 

java . lang . ArraylndexOutOf BoundsException, 
SIMViewException 

6.1 .1 .8.1.1 Normal execution 

• CRRNl: dataLength bytes of the record specified by mode and recNumber of the current selected hnear fixed or 
cyclic EF are updated at recOffset, by using the string of bytes in the array data starting at dataOffset. 

• CRRN2: If the access mode is REC_ACC_MODE_ABSOLUTE_CURRENT and the file is a hnear fixed EF: 

- the record addressed by recNumber will be updated; 

- if recNumber is the current selected record will be updated; and 

- the current record pointer shall not change. 

• CRRN3 : If the access mode is REC_ACC_MODE_NEXT and the file is a linear fixed EF: 

- the next record relative to the current selected record will be selected and updated; 

- if no current record is selected, the first record will be selected and updated; 

- the current record pointer of any other applet shall not be changed. 
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• CRRN4: If the access mode is REC_ACC_MODE_PREVIOUS: 

- the previous record relative to the current selected record will be selected and updated; 

- if no current record is selected, the last record will be selected and updated; 

- if a cyclic EF is updated, the oldest record will be updated independent of the current record pointer and this 
record becomes record number 1 and the current record; 

- the current record pointer of any other applet shall not be changed in case of a hnear fixed EF. 

6.1.1.8.1.2 Parameter errors 

• CRRPl : If the currently selected EF is hnear fixed and the access mode is 
REC_ACC_MODE_ABSOLUTE_CURRENT and recNumber is less than or greater than records available, an 
instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.RECORD_NUMBER_NOT_AVAILABLE. 

• CRRP2: If the currently selected EF is linear fixed and the access mode is 
REC_ACC_MODE_ABSOLUTE_CURRENT, recNumber is and there is no current record selected, an 
instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.RECORD_NUMBER_NOT_AVAILABLE. 

• CRRP3: If the currently selected EF is linear fixed and the access mode is REC_ACC_MODE_NEXT and the 
current record pointer is set to the last record, an instance of SIMViewException shall be thrown. The reason 
code shall be SIMViewException.RECORD_NUMBER_NOT_AVAILABLE. 

• CRRP4: If the currently selected EF is hnear fixed and the access mode is REC_ACC_MODE_PREVIOUS and 
the current record pointer is set to the first record; an instance of SIMViewException shall be thrown. The reason 
code shall be SIMViewException.RECORD_NUMBER_NOT_AVAILABLE. 

• CRRP5: If the specified offset into the selected record recOffset is less than 0, an instance of SIMViewException 
shall be thrown. The reason code shall be SIMViewException. OUT_OF_RECORD_BOUND ARIES. 

• CRRP6: If recOffset plus dataLength is greater than the record lengh, an instance of SIMViewException shall be 
thrown. The reason code shall be SIMViewException.OUT_OF_RECORD_BOUND ARIES. 

• CRRP7: If the access mode is not between 2 and 4 inclusive (2 = REC_ACC_MODE_NEXT, etc.), an instance 
of SIMViewException shall be thrown. The reason code shall be SIMViewException.INVALID_MODE. 

• CRRP8: If the currently selected EF is cyclic and the mode of record access mode is not 
REC_ACC_MODE_PREVIOUS, an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.INVALID_MODE. 

• CRRP9: If the array data is nuU, an instance of NuUPointerException shall be thrown. 

• CRRPIO: If dataOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRPl 1 : If dataLength is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP12: If dataOffset plus dataLength, is greater than the length of the array data.length, or dataOffset equals 
data.length, an instance of ArraylndexOutOfBoundsException shall be thrown. 

6.1.1.8.1.3 Context errors 

• CRRCl : If the calhng applet has currently no EF selected, an instance of SIMViewException shall be thrown. 
The reason code shall be SIMViewException.NO_EF_SELECTED. 

• CRRC2: If the currently selected EF is neither hnear fixed nor cyclic, an instance of SIMViewException shall be 
thrown. The reason code shall be SIMViewException.FILE_INCONSISTENT. 

• CRRC3: If the calhng applet does not fulfil the access condition, UPDATE, to perform this function, an instance 
of SIMViewException shall be thrown. The reason code shall be SIMViewException.AC_NOT_FULFILLED. 
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• CRRC4: If the currently selected EF is invalidated and the file status of the EF does not allow for updating an 
invalidated file, an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.INVALIDATION_STATUS_CONTRADICTION. 

• CRRC5: If the method call causes a memory problem (e.g. memory access error), an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

• CRRC6: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 



6.1.1.8.2 



Test Suite Files 



Additional requirements for the GSM personalization: This test is based on the assumption that the contents of the EEs 
in DFsiMTEST are identical to those defined in the default pre-personalization and the current record pointers have not 
been altered. 

Test Script: API_l_SVW_UPDRSBS_BSS_l.scr 
Test Applet: API_1_SVW_UPDRSBS_BSS_1 .Java 

Load Script: API_l_SVW_UPDRSBS_BSS_l.ldr 
Cleanup Script: API_l_SVW_UPDRSBS_BSS_l.ch- 
Parameter File: API_1_SVW_UPDRSBS_BSS_1 .par 



6.1.1.8.3 



Test Procedure 



_0_ 
1 



Description 



API Expectation 



APDU Expectation 



SIM Initialization 



Responses ignored. 



No EF selected 

recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
recOffset = 

byte[] data = new byte [20] 
dataOffset = 
dataLength = 10 
updateRecord ( ) 



Shall throw 
sim. access. SIMViewException with 
reason code NO EF SELECTED. 



Update Absolute and Current from Linear 
Fixed EF 

1 - fid = DFSIMTEST 
select ( ) 

2 - fid = EFLARU 
select { ) 

// Record pointer not set. 

3 - recNumber = 2 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

data[0:3] = '11' 

recOffset = 

dataOffset = 

dataLength = 4 

updateRecord ( ) 

respOffset = 

respLength = 

readRecord ( ) 



1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 
Resp shall be: 

Resp[0] = '11' 
Resp[1] = '11' 
Resp[2] = '11' 
Resp[3] = '11' 



= 4 
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Id 


Description 


API Expectation 


APDU Expectation 


3 


Update Current from Linear Fixed EF 

1 - fid = DFSIMTEST 

select ( ) 

2 - fid = EFLARU 

select ( ) 

// Set record pointer with mode "next". 

3 - recNumber = 

mode = REC_ACC_MODE_NEXT 

recOffset = 
data[0:3] = '00' 
dataOffset = 
dataLength = 4 
updateRecord ( ) 

// write data with mode "current" 

4 - recNumber = 
data[0:3] = '22' 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
updateRecord ( ) 

// read result with mode "absolute" 

respOffset = 
respLength = 4 
recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE_CDRRENT 
readRecord ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - No exception shall be thrown, 
resp shall be: 

resp[0] = '22' 
resp[1] = '22' 
resp[2] = '22' 
resp[3] = '22' 




4 


Update Next from Linear Fixed EF, no record 
pointer set 

1 - fid = FID_DF_SIMTEST 
select ( ) 

2 - fid = FID_EF_LARU 
select 

3 - recNumber = 

mode = REC_ACC_MODE_NEXT 
recOffset = 
data [0:3] = '33' 
dataOffset = respOffset = 
dataLength = respLength = 4 
updateRecord ( ) 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

readRecord ( ) 


1 - No exception shall be thrown. 
2- No exception shall be thrown. 
3 - No exception shall be thrown. 
Resp shall be: 
Resp[0] = '33' 
Resp[1] = '33' 

Resp[3] = '33' 




5 


Update Next from Linear Fixed EF, record 
pointer set 

1 - recNumber ^ 

mode = REC_ACC_MODE_NEXT 
recOffset = 
data[0:3] = '44' 
dataOffset = 
dataLength = 4 
updateRecord ( ) 

2 - mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

readRecord ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown, 
resp shall be: 

resp[0] = '44' 
resp[1] = '44' 
resp[2] = '44' 
resp[3] = '44' 




6 


Update Next from Linear Fixed EF, no more 
records 

recNumber = 
mode = REC_ACC_MODE_NEXT 
recOffset = 
data[0:3] = '55' 
dataOffset = 
dataLength = 4 
updateRecord ( ) 


Shall throw 

sim. access. SIMViewException with 
reason code 

RECORD NUMBER NOT AVAIL 
ABLE. 




7 


Update Previous from Linear Fixed EF, no 
record pointer set 

1 - fid = DFSIMTEST 
select ( ) 

2 - fid = EFLARU 
select ( ) 

3 - recNumber = 

mode = REC_ACC_MODE_PREVIOUS 

recOffset = 
data[0:3] = '66' 

dataOffset = respOffset = 
dataLength = respLength = 4 
updateRecord ( ) 

4 - mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
readRecord ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - No exception shall be thrown, 
resp shall be: 

resp[0] = '66' 
rfmnfll - 'RR' 

1 CO|J[ 1 J — uu 

resp[2] = '66' 
resp[3] = '66' 
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Id 


Description 


API Expectation 


APDU Expectation 


8 


Update Previous from Linear Fixed EF, record 
pointer set 

1 - recNumber = 

mode = REC_ACC_MODE_PREVIOUS 
recOffset = 
data [0:3] = '77' 
dataOffset = respOffset = 
dataLength = respLength = 4 
updateRecord ( ) 
readRecord ( ) 

2 - mode = REC_ACC_MODE_ABSOLUTE_CURRENT 


1 - No exception shall be thrown 

2 - No exception shall be thrown. 
Resp shall be: 

Resp[0] = 7744' 
Resp[1] = '7744' 
Resp[2] = '7744' 
Resp[3] = '7744' 




9 


Update Previous from Linear Fixed EF , no 
more records 

recNumber = 

mode = REC_ACC_MODE_PREVIOUS 
recOffset = 
data[0:3] = '88' 
dataOffset = respOffset = 
dataLength = respLength = 4 
updateRecord ( ) 


Shall throw 

Sim. access. SIMViewException with 
reason code 

RECORD NUMBER NOT AVAIL 
ABLE. 




10 


Update Previous from Cyclic EF 

1 - fid = FID_DF_SIMTEST 
select ( ) 

2 - fid = FID_EF_CARU 
select ( ) 

3 - recNumber = 2 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
recOffset = 

respOffset = 
respLength = 3 
readRecord ( ) 

4 - recNumber = 2 

mode = REC_ACC_MODE_PREVIOUS 
data[0:2] = resp[0:2] 'FF' 
dataOffset = 
dataLength = 3 
updateRecord ( ) 

5 - recNumber = 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

respOffset = 
respLength = 3 
readRecord ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - No exception shall be thrown. 

5 - No exception shall be thrown, 
resp shall be: 

resp[0] = data[0] 
resp[1] = data[1] 
resp[2] = data[2] 




11 


Update Absolute from Linear Fixed EF beyond 
Records 

1 - fid = EFLARU 
select ( ) 

2 — recNumber — 1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

recOffset = 
dataOffset = 
dataLength = 4 
updateRecord ( ) 
2 - recNumber = 3 
updateRecord { ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim.access.SIMViewException with 
reason code 

RECORD NUMBER NOT AVAIL 
ABLE. 

3 - Shall throw 

sim.access.SIMViewException with 
reason code 

RECORD NUMBER NOT AVAIL 
ABLE. 




12 


No current record in linear fixed EF, update 
current 

1 - fid = EFLARU 

select //No curr rec 

2 - recNumber =0 // curr rec 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
recOffset = 
dataOffset = 
dataLength = 4 
updateRecord ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim.access.SIMViewException with 
reason code 

RECORD NUMBER NOT AVAIL 
ABLE. 




13 


recOffset < 

1 - fid = EFLARU 

select ( ) 

2 - recNumber =1 // rec 1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
recOffset = -1 
dataOffset = 
dataLength = 4 
updateRecord ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim.access.SIMViewException with 
reason code 

OUT OF RECORD BOUNDARIE 
S. 
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Id 


Description 


API Expectation 


APDU Expectation 


14 


recOffset + dataLengtli > Record Lengthi 

1 - fid = EFLARU 

select ( ) 

2 - recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

recOffset = 2 
dataOffset = 
dataLength = 4 
updateRecord ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code 

OUT OF RECORD BOUNDARIE 
S. 




15 


Updating with Invalid mode 

1 - fid = EFLARU 
select { ) 

2 - recNumber = 
mode = 1 
recOffset = 
dataOffset = 
dataLength = 4 
updateRecord ( ) 

3 - mode = 5 
updateRecord ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim.access.SIMViewException with 
reason code INVALID_MODE. 

3 - Shall throw 

sim.access.SIMViewException with 
reason code INVALID_l\/IODE. 




16 


Updating Cyclic EF with invalid mode 

1 - fid = DFSIMTEST 
select ( ) 

2 - fid = EFCARU 
select ( ) 

3 - recNumber = 

mode = REC_ACC_MODE_NEXT 
recOffset = 
data[0:2] = '00' 
dataOffset = 
dataLength = 3 
updateRecord ( ) 

4 - recNumber = 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
updateRecord ( ) 

5 — recNumber = 2 

mode - REC ACC MODE ABSOLUTE CURRENT 
updau eii.ecord ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - Shall throw 

sim.access.SIMViewException with 
reason code INVALID_MODE. 

4 - Shall throw 

sim.access.SIMViewException with 
reason code INVALID_MODE. 

5 - Shall throw 

sim.access.SIMViewException with 
reason code INVALID_MODE. 




17 


data is null 

byte [ ] nullBuf f er = null 
dataOffset = 
dataLength = 10 
updateRecord ( ) 


Shall throw 

java.lang.NullPointerException. 




i Q 
\ O 


uaiaLiTTsei < u 

dataOffset = -1 
dataLength = 10 
updateRecord ( ) 


onaii Tnrow 
java.lang. 

ArraylndexOutOfBoundsException. 




1 Q 


UdldLcliy III < u 

dataOffset = 
dataLength = -1 
updateRecord ( ) 


Ofldll LlllUW 

java.lang. 

ArraylndexOutOfBoundsException. 




20 


dataOffset + dataLength > data.length 

dataOffset = 10 
dataLength = 11 
updateRecord ( ) 


Shall throw 
java.lang. 

ArraylndexOutOfBoundsException. 




21 


EF Is neither Cyclic nor Linear Fixed 

1 - fid = DFSIMTEST 
select ( ) 

2 - fid = EFTNR 
select ( ) 

3 - dataOffset = 
dataLength = 4 
updateRecord ( ) 


■J K 1 _ J.' 1 II 1 1 I 

1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - Shall throw 

sim.access.SIMViewException with 
reason code 
FILEJNCONSISTENT. 
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Id 


Description 


API Expectation 


APDU Expectation 


22 


Access condition not fulfilled 

1 - fid = EFCNU 

select ( ) 

2 - recOffset = 
dataOffset = 
dataLength = 1 

mode = REC_ACC_MODE_PREVIOUS 
updateRecord ( ) 

3 - fid = EFLNU 

select { ) 

4 - recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
recOffset = 
dataOffset = 
dataLength = 1 
updateRecord ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code 
AC_NOT_FULFILLED. 

3 - No exception shall be thrown. 

4 - Shall throw 

sim. access. SIMViewException with 
reason code 
AC_NOT_FULFILLED. 




23 


EF is invalidated 

1 - fid = EFCNR 
invalidate ( ) 

2 - updateRecord ( ) 

3 - rehabilitate ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 
reason code 

INVALIDATION STATUS CONTR 
ADICTION. 

3 - No exception shall be thrown. 





6.1 .1 .8.4 Test Coverage 



CRR Number 


Test Case Number 


N1 


2, 3,4, 5,7, 8, 10 


N2 


2, 3 


N3 


5, 6 


N4 


7, 8, 9, 10 


PI 


11 


P2 


12 


P3 


6 


P4 


9 


P5 


13 


P6 


14 


P7 


15 


P8 


16 


P9 


17 


P10 


18 


P11 


19 


P12 


20 


C1 


1 


C2 


21 


C3 


22 


C4 


23 


C5, C6 


Not Tested 



6.1.1.9 Method seek 

Test Area Reference: API_1_SVW_SEEKB_BSS. 
6.1.1.9.1 Conformance Requirements 

The method with the following header shall be compUant to its definition in the API. 

public short seek (byte mode, 

byte[] patt, 
short pattOffset, 
short pattLength) 
throws java . lang . NullPointerExcept ion, 

java . lang . ArraylndexOutOf BoundsException, 
SIMViewException 
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6.1.1.9.1.1 Normal execution 

• CRRNl: If the pattern in patt with the length pattLength at offset pattOffset is found in the record being 
specified by mode, the current record pointer is set to that record and the record number is returned. The record 
pointer of any other applet is not changed. This will be tested during the testing of the framework. 

• CRRN2: If mode is SEEK_FROM_BEGINNING_FORWARD, the search starts with the first record forward 
towards the end of the file. 

• CRRN3 : If mode is SEEK_FROM_END_B ACKWARD, the search starts with the last record backward towards 
the beginning of the file. 

• CRRN4: If mode is SEEK_FROM_NEXT_FORWARD, the search starts from the next record after the current 
record pointer forward towards the end of fUe. If no current record pointer is selected, the search starts with the 
first record. 

• CRRN5: If mode is SEEK_FROM_PREVIOUS_B ACKWARD, the search starts from the previous record 
before the current record pointer backward towards the beginning of the file. If no current record pointer is 
selected the search starts with the last record. 

• CRRN6: If pattern in patt is not found, an instance of SIMViewException shall be thrown. The reason code shall 
be SIMViewException.PATTERN_NOT_FOUND. 

• CRRN7: If mode is SEEK_FROM_NEXT_FORWARD and the record pointer is at the last record, an instance 
of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.PATTERN_NOT_FOUND. 

• CRRN8: If mode is SEEK_FROM_PREVIOUS_BACKWARD and the record pointer is at the first record, an 
instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.PATTERN_NOT_FOUND. 

6.1.1.9.1.2 Parameter errors 

• CRRPl : If mode is not between and 3 inclusive (0 = SEEK_FROM_BEGI]SrNING_FORWARD, etc.), an 
instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.INVALID_MODE. 

• CRRP2: If the pattern array patt is null, an instance of NullPointerException shall be thrown. 

• CRRP3: If pattOffset is less than 0, an instance of ArraylndexOutOfBoimdsException shall be thrown. 

• CRRP4: If pattLength is less than 0, an instance of ArraylndexOutOfBoimdsException shall be thrown. 

• CRRP5: If pattLength is greater than the size of the record of the currently selected EE, an instance of 
SIMViewException shall be thrown. The reason code shall be 
SIMViewException.OUT_OF_RECORD_BOUNDARIES. 

• CRRP6: If pattOffset plus pattLength is greater than the length of the pattern array patt.length, an instance of 
ArraylndexOutOfBoundsException shall be thrown. 

6.1 .1 .9.1 .3 Context errors 

• CRRCl ; If the calling applet has currently no EF selected, an instance of SIMViewException shall be thrown. 
The reason code shall be SIMViewException.NO_EF_SELECTED. 

• CRRC2: If the currently selected EF is not linear fixed, an instance of SIMViewException shall be thrown. The 
reason code shall be SIMViewException.FILEJNCONSlSTENT. 

• CRRC3: If the calhng applet does not fulfil the access condition, READ, to perform this function, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.AC_NOT_FULFILLED. 

• CRRC4: If the currently selected EF is invalidated and the file status of the EF does not allow for reading an 
invalidated file, an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.INVALIDATION_STATUS_CONTRADICTION. 
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• CRRC5: If the method call causes a memory problem (e.g. memory access error), an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

• CRRC6: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 

6.1.1.9.2 Test Suite Files 

Additional requirements for the GSM personalization: None 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.1.1.9.3 



API_l_SVW_SEEKB_BSS_l.scr 
API_l_SVW_SEEKB_BSS_l.java 
API_1_SVW_SEEKB_BSS_1 .Idr 
API_l_SVW_SEEKB_BSS_l.ldr 
API_l_SVW_SEEKB_BSS_l.par 

Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 





SIM Initialization 


Responses ignored. 




1 


Byte[] patt = new byte [20] 

pattOffset = 
pattLength = 10 

mode = SEEK_FROM_BEGINNING„FORWARD 
seek ( ) 


onaii inrow 

Sim. access. SIMViewException with 
reason code NO_EF_SELECTED. 




2 


Pattern not Found 

1 - fid = DFSIMTEST 

select ( ) 

2 - fid = EFLARU 

select ( ) 

3 - patt [0] = 'DA' 
pattOffset = 
pattLength = 1 

mode = SEEK_FROM_BEGINNING_FORWARD 
seek ( ) 


1 - No exception sliall be thrown. 

2 - No exception shall be thrown. 

3 - Shall throw 

sim.access.SIMViewException with 

rpocnn rndp 

PATTERN_NOT_FOUND. 




3 


Seek from Beginning Forward 

patt [0:2] = '55' 
pattOffset = 
pattLength = 3 

mode = SEEK_FROM_BEGINNING_FORWARD 
seek ( ) 


No exception shall be thrown. Shall 
return 1 




4 


Seek from End Backward 

patt[0:2] = '55' 

pattOffset = 
pattLength = 3 

mode = SEEK_FROM_END_BACKWARD 
seek ( ) 


No exception shall be thrown. Shall 
return 1 




5 


Seek from Next Forward 

patt [0:2] = 'AA' 
pattOffset = 
pattLength = 3 

mode = SEEK_FROM_NEXT_FORWARD 

seek { ) 


No exception shall be thrown. Shall 
return 2 




6 


Last Record, Seek from Next Forward 

mode = SEEK_FROM_NEXT_FORWARD 
seek ( ) 


Shall throw 

sim.access.SIMViewException with 
reason code 

PATTERN NOT FOUND. 




7 


Seek from Previous Backward 

patt [0:2] = '55' 
pattOffset = 
pattLength = 3 

mode = SEEK_FROM_PREVIOUS_BACKWARD 
seek ( ) 


No exception shall be thrown. Shall 
return 1 
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Id 


Description 


API Expectation 


APDU Expectation 


8 


First Record, Seel< from Previous Backward 

SEE K_F ROM_P RE V I OU S_BACKWARD 

seek { ) 


Shall throw 

sim. access. SIMViewException with 
PATTERN NOT FOUND. 




9 


Pattern not Found (out of reach) 

patt[0:2] = '55' 
pattOffset = 
pattLength = 3 

mO'de - S^^K ^^OM N^XT ^O^WA^D 
seekO 


Shall throw 

sim.access.SiMViewException with 
reason code 

PATTERN_NOT_FOUND. 




10 


Invalid mode 

1 - mode = 4 
seek ( ) 

2 - mode = -1 
seek ( ) 


1 - Shall throw 

sim.access.SiMViewException with 
reason code INVALID_l\/IODE 

2 - Shall throw 

Sim.access.SiMViewException with 
reason code INVALID MODE 




11 


patt Is null 

byte[] nullBuffer = null 

mode — bbhjK r HUM bEblNNlNCj r UKWARU 

seek () 


Shall throw 

java.lang.NullPointerException. 




12 


pattOffset < 

patt[0:2] = '55' 

pattOffset = -1 
pattLength = 3 

moae — bnjhjK r HUM BEblNNlNb r UKWAKU 

seek ( ) 


Shall throw 
java.lang. 

ArraylndexOutOfBoundsException 




13 


pattLength < 

patt[0:2] = '55' 
pattOffset = 
pattLength = -1 

mode — ohjEK r ROM bECjlNNlWb r OKWAKU 

seek ( ) 


Shall throw 
java.lang. 

ArraylndexOutOfBoundsException 




14 


pattLength > size of record 

patt [0:4] = '55' 
pattOffset = 
pattLength = 4 

mOQe — otjiljlx r KUiyi rstjLiXiNiNliNLi r UKWAKU 

seek ( ) 


Shall throw 

Sim.access.SiMViewException with 

reason code 

OUT OF RECORD BOUNDARIE 
S 




15 


pattOffset + pattLength > patt.length 

patt[0:2] = '55' 

pattOffset = 1 
pattLength = 3 

mode = SEEK_FROM_BEGINNING_FORWARD 
seek ( ) 


Shall throw 
java.lang. 

ArraylndexOutOfBoundsException 




16 


EF is not Linear Fixed 

1 - fid = EFTNU 
select ( ) 

2 - pattOffset = 
pattLength = 3 

mode = SEEK_FROM_BEGINNING_FORWARD 

seek { ) 

3 - fid = EFCNU 
select ( ) 

seek ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim.access.SiMViewException with 
reason code 
FILEJNGONSISTENT 

3 - Shall throw 

Sim.access.SiMViewException with 

reason code 

FILE INCONSISTENT 




17 


Access condition not fulfilled 

1 - fid = EFLNR 
select ( ) 

2 - patt[0] = '55' 
pattOffset = 
pattLength = 1 

mode = SEEK_FROM_BEGINNING_FORWARD 
seek ( ) 


J hi J." Illl xl 

1 - No exception shall be thrown. 

2 - Shall throw 

Sim.access.SiMViewException with 

reason code 
AC_NOT_FULFILLED. 




18 


EF Is Invalidated 

1 - fid = EFLARU 
select ( ) 

2 - invalidate () 

3 - patt[0] = '55 
pattOffset = 
pattLength = 1 

mode = SEEK_FROM_BEGINNING_FORWARD 
seek ( ) 

4 - rehabilitate ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - Shall throw 

Sim.access.SiMViewException with 
reason code 

INVALIDATION STATUS CONTR 
ADICTION. 

4 - No exception shall be thrown. 
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HRR Niirnhpf 


Tp^t r^ri^p Niitnhpr 

1 CO I wCIOw 1 1 1 IWd 


N1 

IM 1 


9 T - R 7 




"3 
o 




t 


N4 




1 NO 


7 


IMO 


9 R ft Q 


N7 

IN / 


C 

o 


INO 


o 
o 


PI 


1 \j 


P2 


■\ ■\ 


P3 


12 


P4 


13 


P5 


14 


P6 


15 


CI 


1 


C2 


16 


C3 


17 


C4 


18 


C5, C6 


Not Tested 



6.1.1.10 Method increase 

Test Area Reference: API_1_SVW_INCR_BS_BS. 
6.1.1.10.1 Conformance Requirements 

The method with the following header shall be compliant to its definition in the API. 

public short increase (byte [ ] incr, 

short incrOffset, 
byte[] resp, 
short respOffset) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsException, 
SIMViewException 

6.1.1.10.1.1 Normal execution 

• CRRNl: The value in the array incr is added to the value of the last increased / updated record in the currently 
selected cyclic EF. The result is stored in the oldest record and returned in the array resp. The updated record 
becomes record number 1 and is selected as current record. The number of bytes of valid data in resp is returned. 

6.1.1.10.1.2 Parameter errors 

• CRRPl : If the array incr is null, an instance of NullPointerException shall be thrown. 

• CRRP2: If incrOffset is less than 0, an instance of ArraylndexOutOfBoimdsException shall be thrown. 

• CRRP3: If incrOffset plus the value 3, is greater than the length of the array incr.length, an instance of 
ArraylndexOutOfBoundsException shall be thrown. 

• CRRP4: If the result of the addition is greater than the maximum value of the record (represented by aU bytes set 
to 'FF'), an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.MAX_VALUE_REACHED. 

• CRRP5: If the array resp is null, an instance of NullPointerException shall be thrown. 

• CRRP6: If respOffset is less than 0, an instance of ArraylndexOutOfBoundsException shall be thrown. 

• CRRP7: If the remaining length of the array resp at the offset respOffset is less than the length of the record, an 
instance of ArraylndexOutOfBoundsException shall be thrown. 
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6.1.1.10.1.3 



Context errors 



• CRRCl: If the calling applet has currently no EF selected, an instance of SIMViewException shall be thrown. 
The reason code shaU be SIMViewException.NO_EF_SELECTED. 

• CRRC2: If the currently selected EF is not cyclic, an instance of SIMViewException shaU be thrown. The reason 
code shall be SIMViewException.FILE_INCONSISTENT. 

• CRRC3 : If increase is not allowed as indicated by the FCI byte 8 (GSM 11.11: FCI structure of an EF returned 
by the SELECT command), an instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.FILE_INCONSISTENT. 

• CRRC4: If the calling applet does not fulfil the access condition, INCREASE, to perform this function, an 
instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.AC_NOT_FULFILLED. 

• CRRC5: If the currently selected EF is invalidated, an instance of SIMViewException shall be thrown. The 
reason code shall be SIMViewException.INVALIDATION_STATUS_CONTRADICTION. 

• CRRC6: If the method call causes a memory problem (e.g. memory access error), an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

• CRRC7: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 

6.1.1.10.2 Test Suite Files 

Additional requirements for the GSM personalization: None 

Test Script: APl_l_SVW_lNCR_BS_BS_l.scr 

Test Applet: API_1_SVW_INCR_BS_BS_1 .java 

Load Script: API_l_SVW_INCR_BS_BS_l.ldr 

Cleanup Script: API_l_SVW_D^CR_BS_BS_l.ch- 

Parameter File: API_1_SVW_INCR_BS_BS_1 .par 



6.1.1.10.3 



Test Procedure 



_0_ 
1 



Description 



API Expectation 



APDU Expectation 



SIM Initialization 



Responses ignored. 



No EF selected 

byte[] incr = new byte [4] 
byte[] resp = new byte [4] 

incrOffset = 
respOffset = 
increase ( ) 



Shall throw 

sim. access. SIMViewException with 
reason code NO EF SELECTED. 



EFCARU 



1 - fid 
select ( ) 

2 - fid 
select ( ) 

3 - //Set both 
mode = REC_ACC 
data[0:3] = 
dataOffset = 
dataLength = 3 
updateRecord ( ) 
updateRecord ( ) 

4 - incrOffset 
incr[2] = 1 
respOffset = 
increase ( ) 



Increase , verify response 

DFSIMTEST 



records to 00 00 
_MODE PREVIOUS 



00 



1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - No exception shall be thrown. 
resp[] shall contain {0,0,1 ,0}. 
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Id 


Description 


API Expectation 


APDU Expectation 


3 


Increase, verify file 

1 - incrOffset = 1 
incr[2] = 0, incr[3] = 2 
respOffset = 1 
increase ( ) 

2 - resp [ 3 ] = 
recNumber = 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 

recOffset = 
respOffset = 
respLength = 
readRecord ( ) 


1 - No exception shall be thrown. 
resp[] shall contain {0,0,0,3}. 

2 - No exception shall be thrown. 
resp[] shall contain {0,0,3,0}. 




4 


incr is null 

byte [ ] nullBuf f er = null 
incrOffset = 
respOffset = 
increase ( ) 


Shall throw 

java.lang.NullPointerException. 







incrwTTsei < u 

incrOffset = -1 
respOffset = 
increase ( ) 


onaii inrow 
java.lang. 

ArraylndexOutOfBoundsException. 




6 


IncrOffset + 3 > Incr.length 

incrOffset = 2 
respOffset = 
increase ( ) 


Shall throw 
java.lang. 

ArraylndexOutOfBoundsException. 




7 


Reacli Maximum Value 

incr[0] = incr[l] = incr[2] = 'FF' 

incrOffset = 
respOffset = 
increase ( ) 


Shall throw 

sim. access. SiMViewException with 
reason code 

MAX_VALUE_REACHED. 




8 


resp is null 

incr[0] = incr[l] = 0x00' 
incr[2] = '02' 
incrOffset = 
byte [ ] respNull = null 
respOffset = 
increase ( ) 


Shall throw 

java.lang.NullPointerException. 




y 


respuTTsei < u 

incrOffset = 
respOffset = -1 
increase ( ) 


onaii inrow 
java.lang. 

ArraylndexOutOfBoundsException. 




10 


respOffset + recordLength > resp.length 

incrOffset = 

respOffset - 2 
increase ( ) 


Shall throw 
java.lang. 

ArraylndexOutOfBoundsException. 




11 


EF is not Cyclic 

1 - fid = EFTARU 
select ( ) 

z — rricrurrsct — u 
respOffset = 
increase ( ) 

3 - fid = EFLARU 
select ( ) 

4 - incrOffset = 
respOffset = 
increase ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SiMViewException with 
reason code 
FILEJNCONSISTENT. 

3 - No exception shall be thrown. 

4 - Shall throw 

sim. access. SiMViewException with 

rpa*?nn code 

FILE INCONSISTENT. 




12 


Access condition not fulfilled 

1 - fid = EFCNIC 

select ( ) 

2 - incrOffset = 
respOffset = 
increase ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SiMViewException with 
reason code 
AC_NOT_FULFILLED. 




13 


EF Is Invalidated 

1 - fid = EFCARU 
select ( ) 

2 - invalidate () 

3 - incrOffset = 
respOffset = 
increase ( ) 

4 - rehabilitate ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - Shall throw 

sim. access. SiMViewException with 
reason code 

INVALIDATION STATUS CONTR 
ADICTION. 

4 - No exception shall be thrown. 
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Id 


Description 


API Expectation 


APDU Expectation 


14 


Clieck increase not allowed from FCI 

1 - fciOffset = 
fciLength = 8 

select (FID_EF_CINA, f ci . . . ) 
Verify FCI byte 8 (fci[7]) 

2 - incrOffset = 
respOffset = 
increase ( ) 


1 - No exception shall be thrown. 
Bit 7 of resp[7] shall not be set (0), 
indicating that increase is not 
allowed. 

2 - Shall throw 

sim.access.SIMViewException with 

reason code 

FILE INCONSISTENT 





6.1.1.10.4 Test Coverage 



CRR Number 


Test Case Number 


N1 


2, 3 


PI 


4 


P2 


5 


P3 


6 


P4 


7 


P5 


8 


P6 


9 


P7 


10 


CI 


1 


C2 


11 


C3 


14 


C4 


12 


C5 


13 


C6, C7 


Not Tested 



6.1.1.11 Method invalidate 

Test Area Reference: API_1_S VW_INVL. 
6.1.1.11.1 Conformance Requirements 

The method with the following header shiill be compUant to its definition in the API. 

public void invalidate () 

throws SIMViewException 

6.1.1.11.1.1 Normal execution 

• CRRNl: The currently selected EF of the calling applet shall be invalidated, i.e. the flag in the EF file status 
shall be changed accordingly. 

6.1.1.11.1.2 Parameter errors 
No requirements. 

6.1.1.11.1.3 Context errors 

• CRRCl: If the calUng applet has currently no EF selected, an instance of SIMViewException shall be thrown. 
The reason code shall be SIMViewException.NO_EF_SELECTED. 

• CRRC2: If the calling applet does not fulfil the access condition, INVALIDATE, to perform this function, an 
instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.AC_NOT_FULFILLED. 

• CRRC3: If the currently selected EF is already invalidated, an instance of SIMViewException shall be thrown. 
The reason code shall be SIMViewException.INVALIDATION_STATUS_CONTRADICTION. 



ETSI 



3GPP TS 11.13 version 8.2.1 Release 1999 



53 



ETSI TS 101 955 V8.2.1 (2003-04) 



• CRRC4: If the method call causes a memory problem (e.g. memory access error), an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

• CRRC5: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 

6.1.1.11.2 Test Suite Files 

Additional requirements for the GSM personalization: None 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.1.1.11.3 



API_1_SVW_INVL_1 .scr 
API_1_SVW_EWL_1 .Java 
API_1_SVW_INVL_1 .Idr 
API_1_S VW_IN VL_1 .clr 
API_1_SVW_INVL_1 .par 

Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 





SIM Initialization 


Responses ignored. 




1 


No EF is selected 

1 - invalidate 


1 - Shall throw 

sim. access. SIMViewException with 
reason code NO EF SELECTED. 




2 


Invalidate EF 

1 - fid = DFSIMTEST 
select ( ) 

2 - fid = EFTNR 
select ( ) 

3 - invalidate () 

4 - rehabilitate ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - No exception shall be thrown. 




3 


Access condition not fulfilled 

1 - fid = EFCNIV 
select ( ) 

2 - invalidate () 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewException with 

reason code 

AC NOT FULFILLED. 




4 


EF is already invalidated 

1 - fid = EFTNR 
select ( ) 

2 - invalidate () 

3 - invalidate () 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - Shall throw 

sim. access. SIMViewException with 
reason code 

INVALIDATION STATUS CONTR 
ADICTION. 





6.1.1.11.4 Test Coverage 



CRR number 


Test Case Number 


N1 


2 


C1 


1 


C2 


3 


C3 


4 


C4, C5 


Not Tested 



6.1.1.12 Method rehabilitate 

Test Area Reference: API_1_SVW_REHA. 
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6.1.1.12.1 Conformance Requirements 

The method with the following header shall be comphant to its definition in the API. 

public void rehabilitate ( ) 

throws SIMViewException 

6.1.1.12.1.1 Normal execution 

• CRRNl: The currently selected EF of the calUng applet shall be rehabilitated, i.e. the flag in the EF file status 
shall be changed accordingly. 

6.1.1.12.1.2 Parameter errors 

No requirements. 

6.1.1.12.1.3 Context errors 

• CRRCl: If the calling applet has currently no EF selected, an instance of SIMViewException shall be thrown. 
The reason code shall be SIMViewException.NO_EF_SELECTED. 

• CRRC2: If the calling applet does not fulfil the access condition, REHABILITATE, to perform this fimction, an 
instance of SIMViewException shall be thrown. The reason code shall be 
SIMViewException.AC_NOT_FULFILLED. 

• CRRC3: If the currently selected EF is not invalidated, an instance of SIMViewException shall be thrown. The 
reason code shall be SIMViewException.INVALIDATION_STATUS_CONTRADICTION. 

• CRRC4: If the method call causes a memory problem (e.g. memory access error), an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.MEMORY_PROBLEM. 

• CRRC5: If the method call causes an error to occur that is not expected and thus not handled, an instance of 
SIMViewException shall be thrown. The reason code shall be SIMViewException.INTERNAL_ERROR. 

6.1.1.12.2 Test Suite Files 

Additional requirements for the GSM personalization: None 



Test Script: 


APL 


_1_ 


_svw_ 


_REHA_ 


_Lscr 


Test Applet: 


APL 


_1_ 


_svw_ 


_REHA_ 


_l.java 


Load Script: 


APL 


_1_ 


_svw_ 


_REHA_ 


_l.ldr 


Cleanup Script: 


API. 


.1. 


.svw. 


.REHA. 


.l.ck 


Parameter File: 


API. 


.1. 


.svw. 


.REHA. 


.l.par 
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6.1.1.12.3 Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 





SIM Initialization 


Responses ignored. 




1 


No EF is selected 

1 - rehabilitate ( ) 


1 - Shall throw 

sim. access. SIMViewExceptlon with 
reason code NO EF SELECTED. 




2 


Rehabilitate invalidated File 

1 - fid = DFSIMTEST 
select ( ) 

2 - fid = EFCNR 
select ( ) 

3 - invalidate 

4 - rehabilitate 

5 - byte[] incr = new byte[3] = {0,0,1} 
incrOffset = 

byte[] resp = new byte[l] = 1 
respOffset = 
increase ( ) 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 

4 - No exception shall be thrown. 

5 - No exception shall be thrown. 
resp[] shall contain {0,0,1}. 




3 


Access condition not fulfilled 

1 - fid = EFCNRH 
select () 

2 - rehabilitate ( ) 


1 - No exception shall be thrown. 

2 - Shall throw 

sim. access. SIMViewExceptlon with 

reason code 

AC NOT FULFILLED.. 




4 


Rehabilitate validated File 

1 - fid = EFCNR 
select { ) 

2 - rehabilitate 


1 - No exception shall be thrown. 

2 - Shall throw 

sim.access.SIMViewException with 
reason code 

INVALIDATION STATUS CONTR 
ADICTION. 





6.1.1.12.4 Test Coverage 



CRR number 


Test Case Number 


N1 


2 


C1 


1 


C2 


3 


C3 


4 


C4, C5 


Not Tested 



6.1.2 Class SIMSystem 

6.1 .2.1 Method getTheSIMView 

Test Area Reference: API_1_SSY_GETS. 

6.1.2.1.1 Conformance Requirement: 

The method with following header shall comphant to its definition in the API. 

public static SIMView getTheSIMView ( ) 

6.1.2.1.1.1 Normal execution 

• CRRNl: returns a reference to class which implements the SIMView interface. 

6.1 .2.1 .1 .2 Parameters error 

No requirements. 

6.1.2.1.1.3 Context errors 
No requirements. 



ETSI 



3GPP TS 11.13 version 8.2.1 Release 1999 



56 



ETSI TS 101 955 V8.2.1 (2003-04) 



6.1.2.1.2 Test suite files 

No additional requirements for the GSM personalization: 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.1.2.1.3 



API_1_SS Y_GETS_1 .scr 
API_l_SSY_GETS_l.java 
API_1_SS Y_GETS_1 .Idr 
API_1_SS Y_GETS_1 .clr 
API_1_SS Y_GETS_1 .par 

Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


reference not equal null after execute 


The returned reference shall be not 
null after execute 




2 


reference to the GSM interface 


Returned a reference to the GSM 
interface 





6.1.2.1.4 Test Coverage 



CRR number 


Test case number 


N1 


1,2 



6.1 .3 Class SIMViewException 
6.1.3.1 Method throwit 

Test Area Reference: API_1_SVE_THITS. 

6.1.3.1.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

public static void throwit (short reason) 
throws SIMViewException 

6.1.3.1.1.1 Normal execution 

• CRRNl: Throws the JCRE instance of SIMViewException with the specified reason. 

• CRRN2: Extends javacard.framework.CardRuntimeException. 

6.1.3.1.1.2 Parameter errors 
No requirements. 

6.1.3.1.1.3 Context errors 
No requirements. 

6.1.3.1.2 Test Suite Files 

No additional requirements for the GSM personalization. 
Test Script: API_l_SVE_THITS_l.scr 
Test Applet: API_l_SVE_THITS_l.java 
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Load Script: 
Cleanup Script: 
Parameter File: 

6.1.3.1.3 



API_1_S VE_THITS_1 .Idr 
API_1_S VE_THITS_1 .clr 
API_1_S VE_THITS_1 .par 

Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Throws the JCRE instance of 
SIMViewException with the specified reason 


Reason = 




2 


Throws the JCRE instance of 
SIMViewException with the specified reason 


Reason = 1 




3 


Throws the JCRE instance of 
SIMViewException with the specified reason 


Reason = 1 5 




4 


SIMViewException extends 
javacard.framework.CardRuntimeException 


Reason = 




5 


SIMViewException extends 
javacard.framework.CardRuntimeException 


Reason = 1 




6 


SIMViewException extends 
javacard.framework.CardRuntimeException 


Reason = 1 5 





6.1.3.1.4 Test Coverage 



CRR number 


Test case number 


N1 


1,2,3 


N2 


4,5,6 



6.1.3.2 Constructor 

Test Area Reference: API_l_SVE_COORS. 

6.1.3.2.1 Conformance Requirement 

The method with following header shall compliant to its definition in the API. 

public SIMViewException (short reason) 
throws SIMViewException 

6.1 .3.2.1 .1 Normal execution 

• CRRNl: Construct a SIMViewException with the specified reason. 

6.1 .3.2.1 .2 Parameters error 
No requirements. 

6.1.3.2.1.3 Context errors 
No requirements. 

6.1.3.2.2 Test suite files 

No additional requirements for the GSM personalization: 
Test Script: API_l_SVE_COORS_l.scr 
Test Applet: API_l_SVE_COORS_l.java 
Load Script: API_l_SVE_COORS.ldr 
Cleanup Script: API_l_SVE_COORS.clr 
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6.1.3.2.3 



Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


SIMViewException with the specified reason 

(The reason shall set with setReason and 
compare the Exception with getReason) 


Reason (specified) 





6.1.3.2.4 



Test Coverage 



CRR number 


Test case number 


N1 


1 



6.1.3.3 Reason Codes 

Test Area Reference: API_l_SVE_CONS. 

6.1.3.3.1 Conformance Requirement 

There is no API, only constants. This constants shall compliant to its definition in the API. 

6.1 .3.3.1 .1 Normal execution 

• CRRNl : The Constants of the class SIMViewException shall all have the same name and value defined in the 
GSM 03.19. 

• CRRN2: Constructs SIMViewException a Exception with the specified reason. 



6.1.3.3.1.2 

No requirements. 

6.1.3.3.1.3 

No requirements. 

6.1.3.3.2 

None 

6.1.3.3.3 



Parameters error 



Context errors 



Test suite files 



Test Procedure 



The constants in Java are resolved at compilation time, therefore a runtime test is not useful. No test of constants will be 
performed. 

6.2 Package sim.toolkit 

6.2.1 Interface ToolkitConstants 
6.2.1.1 Constants 

Test Area Reference: API_2_TKC_CONS. 
6.2.1.1.1 Conformance Requirement 

There is no API, only constants. This constants shall be compare to its definition in the API. 



ETSI 



3GPP TS 11.13 version 8.2.1 Release 1999 59 ETSI TS 101 955 V8.2.1 (2003-04) 

6.2.1.1.1.1 Normal execution 

• CRRNl: The Toolkit Constants shall all have the same name and value defined in the GSM 03.19 
normalization. 

6.2.1.1.1.2 Parameters error 
No requirements. 

6.2.1.1.1.3 Context errors 
No requirements. 

6.2.1.1.2 Test suite files 
None. 

6.2.1.1.3 Test Procedure 

The constants in Java are resolved at compilation time, therefore a runtime test is not useful. No test of constants will be 
performed. 

6.2.2 Interface Toolkitlnterface 
6.2.2.1 Method processToolkit 

Test Area Reference: API_2_TKI_PRTKB. 
6.2.2.1.1 Conformance Requirement 

The method with following prototype shall be compliant to its definition in the API. 

public void processToolkit (byte event) 
throws ToolkitExcept ion 

6.2.2.1 .1 .1 Normal execution 

• CRRNl : This interface must be implemented by a Toolkit applet (which extends the javacard.framework. Applet 
class) so that it can be triggered by the Toolkit Handler according to the registration information. 

• CRRN2: The Toolkit applet will have to implement the processToolkit shared method so that the following 
events can be notified. 
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Event 


Description 


EVENT_PROFILE_DOWNLOAD 


Terminal Profile command reception 


EVENT_FORMATTED_SMS_PP_ENV 


Formatted envelope SMS-PP Data Download 
reception 


EVENT_FORMATTED_SMS_PP_UPD 


Formatted Update Record EF SI\/IS 


EVENT FORMATTED SMS CB 


Formatted envelope Cell Broadcast Data 
Download command reception 


EVENT_UNFORMATTED_SMS_PP_ENV 


Unformatted Envelope SMS-PP Data Download 
reception 


EjVhjJMl UJMr URMAl IhjU oMb FF UFU 


Unformatted Update Record EF SMS 


EVENT_UNFORMATTED_SMS_CB 


Unformatted Cell Broadcast Data Download 
command reception 


h VhN i MhNU br^LhO i 1(JN 


Envelope IVIenu Selection command reception 


h vhN i MhNU br^LhO i 1(JN HhLP Rhy UiIjO i 


Envelope Menu Selection Help Request 
command reception 


Ilj VlliiN 1 l^iiij J-i l^UiN 1 KU J-i l5 1 o -Lr'I 


Envelope Call Control by SIM command reception 




Envelope MO Short Message Control by SIM 

command reception 


■p^/FMT T TMFR F YP TR fl T J OKI 

JZj V IijiN X X ±i iiZjrX nj^Jr ± rxH X ± WIN 


Envelope Timer Expiration 




Envelope Event Download - MT call 




Envelope Event Download - Call connected 




tvenT uowniOaQ - Uaii oisconneciGQ 




EnvGlopG EvGnt Download - Location status 


EVENT EVENT DOWNLOAD USER ACTIVITY 


1— n\/olnr»o F\/ont nir»\A/nlr»aH - 1 Icor ar'ti\/it\/ 
^1 1 vUlUjJt:; ^Vcl IL L/UWIIIUavJ UotJI a.L»LlvlLy 


EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 


Envelope Event Download - Idle screen available 


EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 


Envelope Event Download - Card Reader Status 


EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION 


Envelope Event Download - Language Selection 


EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION 


Envelope Event Download - Browser Termination 


EVENT_STATUS_COMMAND 


Status APDU command event 


EVENT_UNRECOGNI ZED_ENVELOPE 


Unrecognized Envelope command reception 



6.2.2.1 .1 .2 Parameters error 

No requirements. 

6.2.2.1 .1 .3 Context errors 

No requirements. 

6.2.2.1.2 Test suite files 
The method is tested in the Framework. 

6.2.2.1 .3 Test Coverage 



CRR number 


Test case number 


N1 


Tested in Framework 


N2 


Tested in Framework 



6.2.3 Class EditHandler 

It is not possible to test the methods provided by this class as it is declared 'abstract'; it will be done in the class 
inheriting it: EnvelopeResponseHandler, ProactiveHandler. 

6.2.4 Class EnvelopeHandler 
6.2.4.1 Method getEnvelopeTag 

Test Area Reference: API_2_ENH_GENT. 
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6.2.4.1.1 Conformance Requirement 

The method with following header shaU be compliant to its definition in the API. 

public byte getEnvelopeTag ( ) 

6.2.4.1 .1 .1 Normal execution 

• CRRN 1 : The method shall return the Envelope BER-TLV tag. 

• CRRN2: The Envelope BER TAG is available for all triggered toolkit applets from the invocation to the 
termination of their processTooUdt method if the EnvelopeHandler is available. 



6.2.4.1.1.2 

No requirements. 

6.2.4.1.1.3 

No requirements. 

6.2.4.1.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.4.1.3 



Parameters error 
Context errors 
Test suite files 

API_2_ENH_GENT_1 .scr 
API_2_ENH_GENT_1 .Java 
API_2_ENH_GENT_1 .Idr 
API_2_ENH_GENT_1 .ch 
API_2_ENH_GENT_1 .par 

Test Procedure 



Id 


Description 


APi Expectation 


APDU Expectation 


1 


getEnvelopeTag called just after triggering of the 
application. 


Returns OxDI 




2 


getEnvelopeTag called after a proactive 
command. 


Returns OxDI 




3 


getEnvelopeTag called after a second proactive 
command. 


Returns OxDI 





6.2.4.1.4 Test Coverage 



CRR number 


Test case number 


N1 


1, 2, 3 


N2 


1, 2, 3 



6.2.4.2 Method getltem Identifier 

Test Area Reference: API_2_ENH_GIID. 

6.2.4.2.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getltemldentif ier ( ) 

throws ToolkitException 
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6.2.4.2. 1 . 1 Normal execution 

• CRRNl :The method shall return the item identifier byte value. 

• CRRN2:The item identifier byte value returned shall be iiom the first Item Identifier TLV element. 

• CRRN3: If the element is available it becomes the TLV selected. 

• CRRN4: The item identifier is available for all triggered toolkit applets from the invocation to the termination of 
their processToolkit method if the EnvelopeHandler is available. 

6.2.4.2.1.2 Parameters error 
No requirements. 

6.2.4.2. 1 .3 Context errors 

• CRRC 1 : The method shall throw ToolkitException (UN AVAILABLE_ELEMENT) if the item identifier TLV is 
not present. 

• CRRC2: The method shall throw ToolkitException (OUT_OF_TLV_BOUND ARIES) if the item identifier byte 
is missing in the Item Identifier Simple TLV. 



6.2.4.2.2 Test suite files 



Test Script: 


APL 


_2_ 


_ENH_ 


_GIID_ 


_l.scr 


Test Applet: 


API. 


.2. 


ENH. 


GIID. 


.l.java 


Load Script: 


API. 


.2. 


ENH. 


Giro. 


.l.ldr 


Cleanup Script: 


API. 


.2. 


ENH. 


Giro. 


.l.ch 


Parameter File: 


API. 


.2. 


ENH. 


Giro. 


.l.par 



6.2.4.2.3 Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send envelope SMS-PP Formatted with Item 

identifier TLV and identifier value of 03 


Returns 03 




2 


Send envelope SMS-PP Formatted with two item 
identifier TLV with first value FF and second 44 


Returns FF 




3 


Send envelope SMS-PP Formatted with two item 
identifier TLV with first value 81 and second 44, 
call twice the method getltemldentifier 


Returns 81 
Returns 81 




4 


Send envelope SMS-PP Formatted with item 
identifier TLV and value of 66. FindTLV with TAG 
02. getltemldentifier and then getValueByte with 
offset 


getltemldentifier=getValueByte 




5 


Send envelope SMS-PP Formatted without item 
identifier TLV and getltemldentifier 


ToolkitException 
(UNAVAILABLE_ELEMENT) 




6 


Send Envelope SMS-PP Formatted with item 
identifier TLV (66), send proactive command. Then 
getltemldentifier 


Returns 66 




7 


Send Envelope SMS-PP Formatted with item 
identifier TLV but without item number 


ToolkitException 
(OUT_OF_TLV_BOUNDARIES) 
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CRR number 


Test case number 


N1 


1, 2, 3 


N2 


2, 3 


N3 


4 


N4 


6 


C1 


5 


C2 


7 



6.2.4.3 Method getSecuredDataLength 

Test Area Reference: API_2_ENH_GSDL. 

6.2.4.3.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

public short getSecuredDataLength ( ) 

throws ToolkitException 

6.2.4.3.1.1 Normal execution 

• CRRN 1 : The method shall return the length of the secured data contained in a SMS TPDU TLV. 

• CRRN2: The length is from the first SMS TPDU TLV. 

• CRRN3: The length should not include padding bytes. 

• CRRN4: The method can be used if the event is EVENT_FORMATTED_SMS_PP_ENV and if the SMS TP- 
UD is formatted according to GSM 03.48 [8]. 

• CRRN5: The method can be used if the event is EVENT_FORMATTED_SMS_PP_UPD and if the SMS TP- 
UD is formatted according to GSM 03.48 [8]. 

• CRRN6: The method can be used if the event is EVENT_FORMATTED_SMS_CB and if the Cell Broadcast 

Page is formatted according to GSM 03.48 [8]. 

• CRRN7: If the method is successful and if the event is EVENT_FORMATTED_SMS_PP_ENV, the selected 
TLV should be the SMS TPDU TLV. 

• CRRN8: If the method is successful and if the event is EVENT_FORMATTED_SMS_CB, the selected TLV 
should be the Cell Broadcast Page TLV. 

6.2.4.3.1.2 Parameters error 
No requirements. 

6.2.4.3. 1 .3 Context errors 

• CRRC 1 : The method shall thrown ToolkitException (UN AVAILABLE_ELEMENT) in case of unavailable 
SMS TPDU TLV element. 

• CRRC2: The method shall thrown ToolkitException (UNAVAILABLE_ELEMENT) in case of missing Secured 
Data. 

6.2.4.3.2 Test suite files 

Specific triggering: 

- FORMATTED SMS CB. 

- UNFORMATTED SMS CB. 
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- FORMATTED SMS PP UPD. 

- UNFORMATED SMS PP ENV. 

- For Formatted triggering if CC/RC/DS is used, the security parameters are the one used for downloading 
applications. 



Test Script: 


API. 


.2. 


.ENH. 


.GSDL. 


.l.scr 


Test Applet: 


API. 


.2. 


.ENH. 


.GSDL. 


.l.java 


Load Script: 


API. 


.2. 


.ENH. 


.GSDL. 


.l.ldr 


Cleanup Script: 


API. 


_2_ 


_ENH_ 


_GSLD_ 


_l.clr 


Parameter File: 


AP1_ 


X 


_ENH 


_GSLD_ 


_l.par 



6.2.4.3.3 Test procedure 



IQ 


uescnpiion 


Arl CXpGCIallOn 


Aruu cxpeciaiion 


1 


Test with FORMATTED_SMS_PP_ENV and TP- 
UA lengTn or d. 


Returns 0x2A 




2 


Test with TP-OA length of 6 


Returns 0x2A 




o 
O 


1 Gst witn 1 r-UA lengtn ot i 


rieturns uxtiA 




4 


Test with RC/CC/DS length of 


Returns 0x10 




5 


Test with RC/CC/DS length of 8 


Returns 0x1 




6 


Test with PCNTR = 


Returns 0x1 




7 


— ■— . •■1 r~vj^K i-f"r*\ ^ 

Test with PCNTR = 7 


Returns 0x05 




8 


Test with SecuredDataLength = 00 


Returns 0x00 




9 


Test with UserDataLength = 0x33 


Returns 0x33 




10 


Test with UserDataLength = Ox 6C 


Returns Ox 6C 




11 


Test with UserDataLength = Ox 6D 


Returns Ox 6D 




12 


Test with UserDataLength = maximum length: 
0x79 


Returns Ox 79 




13 


Verify it is the first TPDU TLV: 

Send a SMS PP with 2 TPDU TLV and inside two 

different secured data lengths: 5 and 10 


Returns 0x05 




14 


Same test as 1 but with 
FORMATTED SMS PP UPD 


Returns 0x2A 




15 


Same test as 2 but with 

rUriMA 1 1 bU oMb rr UrU 


Returns 0x2A 




16 


Same test as 3 but with 
FORMATTED SMS PP UPD 


Returns 0x2A 




17 


Same test as 4 but with 
FORMATTED SMS PP UPD 


Returns 0x1 




18 


Same test as 5 but with 
FORMATTED SMS PP UPD 


Returns 0x10 




19 


Same test as 6 but with 
FORMATTED SMS PP UPD 


Returns 0x1 




20 


Same test as 7 but with 
FORMATTED SMS PP UPD 


Returns 0x05 




21 


Same test as 8 but with 
FORMATTED SMS PP UPD 


Returns 0x00 




22 


Same test as 9 but with 
FORMATTED SMS PP UPD 


Returns 0x33 




23 


Same test as 1 but with 
FORMATTED SMS PP UPD 


Returns Ox 6C 




24 


Same test as 1 1 but with 
FORMATTED SMS PP UPD 


Returns Ox 8D 




25 


Same test as 1 2 but with 
FORMATTED SMS PP UPD 


Returns Ox 79 




26 


Same test as 13 but with 
FORMATTED SMS PP UPD 


Returns 0x05 




27 


Same test as 4 but with FORMATTED SMS CB 


Returns 0x10 




28 


Same test as 5 but with FORMATTED SMS CB 


Returns 0x1 




29 


Same test as 6 but with FORMATTED SMS CB 


Returns 0x1 
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Id 


Description 


API Expectation 


APDU Expectation 


30 


Same test as 7 but with FORMATTED SMS CB 


Returns 0x05 




31 


Same test as 8 but with FORMATTED SMS CB 


Returns 0x00 




32 


Same test as 9 but with FORMATTED SMS CB 


Returns 0x33 




33 


Same test as 12 but with maximum length: 0x42, 
and FORMATTED SMS CB 


Returns Ox 42 




34 


Test with FORMATTED_SMS_PP_ENV 
Verify after call of the method the current TLV is 
the TPDU TLV: 

findTLV device identities, getSecuredDataLength 
and then getValueByte to verify that the current 
TLV is the TPDU TLV 


getValueByte returns 0x40 




35 


Test with FORMATTED_SMS_CB 

Verify after call of the method the current TLV is 

the Cell Broadcast Page TLV: 

findTLV device identities, getSecuredDataLength 

and then getValueByte to verify that the current 

TLV is the Cell Broadcast Page TLV 


getValueByte returns 0x58 




36 


Send an envelope SMS CB, 

getSecuredDataLength 


ToolkitException 
UNAVAILABLE ELEMENT 




37 


Send an envelope SMS PP unformatted 


ToolkitException 
UNAVAILABLE ELEMENT 





6.2.4.3.4 Test Coverage 

This method has only been tested with call control and the tests shall be improved during GSM 03.48 [8] tests. 



CRR number 


Test case number 


N1 


1,2, 3, 4,5, 6, 7,8, 9,10,11,12,13 


N2 


13 


N3 


6, 7 


N4 


1,2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 25 


N5 


14, 15, 16, 17, 18, 19, 20, 21, 22, 23, 24, 25, 26 


N8 


27, 28, 29, 30, 31, 32, 33 


N7 


34 


N8 


35 


CI 


36 


C2 


37 



6.2.4.4 Method getSecuredDataOffset 

Test Area Reference: API_2_ENH_GSDO. 
6.2.4.4.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

public short getSecuredDataOf f set ( ) 

throws ToolkitException 

6.2.4.4.1.1 Normal execution 

• CRRN 1 : The method shall return the offset of the secured data first byte contained in a SMS TPDU TLV. 

• CRRN2: The offset is fi-om the first SMS TPDU TLV. 

• CRRN3 : The method can be used if the event is EVENT_FORM ATTED_SMS_PP_ENV and if the SMS TP- 
UD is formatted according to GSM 03.48 [8]. 

• CRRN4: The method can be used if the event is EVENT_FORMATTED_SMS_PP_UPD and if the SMS TP- 
UD is formatted according to GSM 03.48 [8]. 
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• CRRN5: The method can be used if the event is EVENT_FORMATTED_SMS_CB and if the Cell Broadcast 

Page is formatted according to GSM 03.48 [8]. 

• CRRN6: If the method is successful and if the event is EVENT_FORMATTED_SMS_PP_ENV, the selected 
TLV should be the SMS TPDU TLV. 

• CRRN7: If the method is successful and if the event is EVENT_FORMATTED_SMS_CB, the selected TLV 
should be the Cell Broadcast Page TLV. 

6.2.4.4.1.2 Parameters error 
No requirements. 

6.2.4.4. 1 .3 Context errors 

• CRRC 1 : The method shall thrown ToolkitException (UN A VAILABLE_ELEMENT) in case of unavailable 
SMS TPDU TLV element. 

• CRRC2: The method shall thrown ToolkitException (UNAVAILABLE_ELEMENT) in case of missing Secured 
Data. 

6.2.4.4.2 Test suite files 

Specific triggering: 

- FORMATTED SMS CB. 

- UNFORMATTED SMS CB. 

- FORMATTED SMS PP UPD. 

- UNFORMATED SMS PP ENV. 

- For Formatted triggering if CC/RC/DS is used, the security parameters are the one used for downloading 
applications. 



Test Script: 


API. 


.2. 


ENH. 


.GSDO. 


.l.scr 


Test Applet: 


API. 


.2. 


ENH. 


.GSDO. 


.l.java 


Load Script: 


API. 


.2. 


ENH. 


.GSDO. 


.l.ldr 


Cleanup Script: 


API. 


_2_ 


_ENH_ 


_GSDO_ 


_l.clr 


Parameter File: 


API. 


.2. 


.ENH. 


.GSDO. 


.l.par 



6.2.4.4.3 Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Test with TP-OA length of 2 


Returns 0x21 




2 


Test with TP-OA length of 6 


Returns 0x23 




3 


Test with TP-OA length of 1 2 


Returns 0x26 




4 


Test with RC/CC/DS length of 


Returns 0x21 




5 


Test with RC/CC/DS length of 8 


Returns 0x29 




6 


Send a SI\/IS PP with 2 TPDU TLV and inside two 
different secured data offsets 


Returns 0x24 ( the first offset ) 




7 


Same test as 1 but with 
FORMATTED SMS PP UPD 


Returns 0x21 




8 


Same test as 2 but with 
FORMATTED SMS PP UPD 


Returns 0x23 




9 


Same test as 3 but with 
FORMATTED SMS PP UPD 


Returns 0x26 




10 


Same test as 4 but with 
FORMATTED SMS PP UPD 


Returns 0x21 
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Id 


Description 


APi Expectation 


APDU Expectation 


11 


Same test as 5 but with 
FORMATTED SMS PP UPD 


Returns 0x29 




12 


Same test as 6 but with 
FORIVIATTED SIVIS PP UPD 


Returns 0x24 ( the first offset ) 




13 


Test with FORMATTED_SMS_PP ENV 

Verify after call of the method the current TLV is 

the TPDU TLV: 

findTLV device identities, getSecuredDataOffset 
and then getValueByte to verify that the current 

TLV is the TPDU TLV 


Returns 0x40 




14 


Same test as 4 but with FORMATTED SMS CB 


Returns 0x16 




15 


Same test as 5 but with FORMATTED SMS CB 


Returns 0x1 E 




16 


Test with FORMATTED_SMS_CB 

Verify after call of the method the current TLV is 

the Cell Broadcast Page TLV: 

findTLV device identities, getSecuredDataOffset 

and then getValueByte to verify that the current 

1 LV IS the Cell Broadcast rage i LV 


Returns 0x58 




17 


Send an UNFORMATTED SMS CB envelope, 
getSecu red DataOf f set 


ToolkitException 
UNAVAILABLE ELEMENT 




18 


Send an UNFORMATTED SMS PP envelope 


ToolkitException 
UNAVAILABLE ELEMENT 




19 


Send an FORMATTED SMS-PP envelope with no 
secured data, getSecuredDataOffset 


Returns 0x21 





6.2.4.4.4 Test Coverage 

This method has only been tested with call control and the tests shall be improved during GSM 03.48 [8] tests. 



GRR number 


Test case number 


N1 


1, 2, 3, 4, 5, 6, 19 


N2 


6, 12 


N3 


1, 2, 3, 4, 5, 6, 19 


N4 


7, 8, 9, 10, 11 


N5 


14,15 


N6 


13 


N7 


16 


CI 


17 


C2 


18 



6.2.4.5 Method getTheHandler 

Test Area Reference: API_2_ENH_GTHD. 

6.2.4.5.1 Conformance Requirements 

The method with following header shall be compliant to its definition in the API. 

public static EnvelopeHandler getTheHandler ( ) 

throws ToolkitException 

6.2.4.5. 1 . 1 Normal execution 

• CRRNl: The method shall return the single system instance of the EnvelopeHandler class. 

• CRRN2: The EnvelopeHandler is a Temporary JCRE Entry Point Object ( see Javacard 2.1 Runtime 
Environment (JCRE) Specification [12]). 

6.2.4.5.1.2 Parameters error 

No requirements. 
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6.2.4.5. 1 .3 Context errors 

• CRRCl : The method shall thrown ToolkitException (HANDLER_NOT_AVAILABLE) if the handler is busy. 



6.2.4.5.2 Test suite files 



Test Script: 


API_ 


_2_ 


_ENH_ 


_GTHD_ 


_l.scr 


Test Applet: 


API. 


.2. 


ENH. 


.GTHD. 


.l.java 


Load Script: 


API. 


.2. 


ENH. 


.GTHD. 


.l.ldr 


Cleanup Script: 


API. 


.2. 


ENH. 


.GTHD. 


.l.ch 


Parameter File: 


API. 


.2. 


ENH. 


.GTHD. 


.l.par 



6.2.4.5.3 Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


getTheHandler twice 


The returned objects shall be the 
same 




2 


Verify that getllieHandler returns an EnvelopeHandler 
GetTheHandler 


The reference returned shall be an 
EnvelopeHandler (checkcast) 




3 


Verify the returned value is not null 
GetTheHandler 


The reference returned shall not be 
null. 





6.2.4.5.4 Test Coverage 



CRR number 


Test case number 


N1 


1, 2, 3 


N2 


To be checked in Framework tests and insert here cross reference 


CI 


To be checked in Framework tests and insert here cross reference 



6.2.4.6 Method getTPUDLOffset 

Test Area Reference: API_2_ENH_GTPO. 

6.2.4.6.1 Conformance Requirement: 

The method with following header shall be compliant to its definition in the API. 

public short getTPUDLOf f set ( ) 

throws ToolkitException 

6.2.4.6. 1 . 1 Normal execution 

• CRRN 1 : The method shall return the TPUDL offset in a SMS TPDU TLV. 

• CRRN2: The offset is from the first SMS TPDU TLV. 

• CRRN3 : The method can be used if the event is EVENT_FORMATTED_SMS_PP_ENV. 

• CRRN4: The method can be used if the event is EVENT_FORMATTED_SMS_PP_UPD. 

• CRRN5 : The method can be used if the event is EVENT_UNFORMATTED_SMS_PP_ENV. 

• CRRN6: The method can be used if the event is EVENT_UNFORMATTED_SMS_PP_UPD. 

• CRRN7: If the method is successful, the selected TLV should be the SMS TPDU TLV. 
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6.2.4.6.1.2 Parameters error 

No requirements. 

6.2.4.6.1.3 Context errors 

• CRRC 1 : The method shall thrown ToolkitException (UNAVAILABLE_ELEMENT) in case of unavailable 
SMS TPDU TLV element. 

• CRRC2: The method shall thrown ToolkitException (UNAVAILABLE_ELEMENT) if the TPUDL field does 
not exist. 

6.2.4.6.2 Test suite files 

Specific triggering: 

FORMATTED SMS PP UPD 
UNFORMATTED SMS PP UPD 
UNFORMATTED SMS PP ENV 
SMS CB 



Test Script: 


APT 


_2_ 


_ENH_ 


_GTPO_ 


_l.scr 


Test Applet: 


APT 


_2_ 


_ENH_ 


_GTPO_ 


_l.java 


Load Script: 


APT 


_2_ 


_ENH_ 


_GTPO_ 


_l.ldr 


Cleanup Script: 


API. 


.2. 


ENH. 


.GTPO_ 


.l.clr 


Parameter File: 


API. 


.2. 


ENH. 


.GTPO_ 


.l.par 



6.2.4.6.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Test with TP-OA length of 2 


Returns OxOD 




2 


Test with TP-OA length of 6 


Returns 0x0 F 




3 


Test with TP-OA length of 1 2 


Returns 0x12 




4 


Send a SMS PP with 2 TPDU TLV and inside two 

different DDL offsets 


Returns 0x10 (the first offset) 




5 


Same test as 1 but with 
FORMATTED SMS PP UPD 


Returns OxOD 




6 


Same test as 2 but with 
FORMATTED SMS PP UPD 


Returns OxOF 




7 


Same test as 3 but with 
FORMATTED SMS PP UPD 


Returns 0x12 




8 


Same test as 4 but with 
FORMATTED SMS PP UPD 


Returns 0x10 (the first offset) 




9 


Same test as 1 but with 
UNFORMATTED SMS PP UPD 


Returns OxOD 




10 


Same test as 2 but with 
UNFORMATTED SMS PP UPD 


Returns OxOF 




11 


Same test as 3 but with 
UNFORMATTED SMS PP UPD 


Returns 0x12 




12 


Same test as 4 but with 
UNFORMATTED SMS PP UPD 


Returns 0x12 (the first offset) 




13 


Same test as 1 but with 
UNFORMATTED SMS PP ENV 


Returns OxOD 




14 


Same test as 2 but with 
UNFORMATTED_SMS_PP_ENV 


Returns OxOF 




15 


Same test as 3 but with 
UNFORMATTED SMS PP ENV 


Returns 0x12 




16 


Same test as 4 but with 
UNFORMATTED SMS PP ENV 


Returns 0x10 (the first offset) 
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Id 


Description 


API Expectation 


APDU Expectation 


17 


\ / ' L ll II X xi xi \ Li L ^ni \ / ' Xl 

Verify after call of the method the current TLV is the 
TPDU TLV: 

findTLV device identities, getTPUDLOffset and then 
getValueByte to verify that the current TLV is the 
TPDU TLV 


Returns 0x40 




18 


Send an envelope SMS CB, getTPUDLOffset 


ToolkitException 
UNAVAILABLE ELEMENT 





6.2.4.6.4 Test Coverage 



CRR number 


Test case number 


N1 


1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17 


N2 


4 


N3 


1, 2, 3, 4, 17 


N4 


5, 6, 7, 8 


N5 


13, 14, 15, 16 


N6 


9, 10, 11, 12 


N7 


17 


CI 


18 


C2 


Don't no how to test 



6.2.4.7 Method getLength 

Test Area Reference: API_2_ENH_GLEN. 

6.2.4.7.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

public short getLength () 

throws ToolkitException 

6.2.4.7. 1 . 1 Normal execution 

• CRRNl : returns the length in bytes of the TLV list. 

6.2.4.7.1.2 Parameter Error 
No requirements. 

6.2.4.7. 1 .3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

6.2.4.7.2 Test Suite files 
Specific triggering: None 

Test Script: API_2_ENH_GLEN_l.scr 

Test Applet: API_2_ENH_GLEN_1 .Java 

Load Script: API_2_ENH_GLEN_Lldr 

Cleanup Script: API_2_ENH_GLEN_1 .ck 

Parameter File: API_2_ENH_GLEN_1 .par 



ETSI 



3GPP TS 11 .1 3 version 8.2.1 Release 1 999 71 ETSI TS 1 01 955 V8.2.1 (2003-04) 



6.2.4.7.3 Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send an envelope SMS PP with BER lengtti of 0x31 


Result of getLengthO is 0x0031 




2 


Send an envelope SMS PP with BER length of 0x7F 


Result of getLengthO is 0x007Fh 




3 


Send an envelope SMS PP with BER length of 81 80 


Result of getLengthO Is OxOOSOh 




4 


Send an envelope SMS PP with BER length of 81 FC 


Result of getLengthO is OxOOFCh 





6.2.4.7.4 Test Coverage 



CRR number 


Test case number 


N1 


1,2,3,4 


CI 


Does not apply for EnvelopeHandler 



6.2.4.8 Method copy 

Test Area Reference: API_2_ENH_COPY_BSS. 

6.2.4.8.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

public short copy (byte [] dstBuffer, 
short dstOffset, 
short dstLength) 
throws java . lang .NullPointerException, 

java . lang .Array IndexOutOfBoundsExcept ion, 
ToolkitException 

6.2.4.8. 1 . 1 Normal execution 

• CRRNl : copies the simple TLV hst contained in the handler to the destination byte array. 

• CRRN2: returns dstOffset + dstLength. 

6.2.4.8. 1 .2 Parameter errors 

• CRRPl : if dstBuffer is nuU a NullPointerException is thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative, 
an ArraylndexOutOfBoundsException is thrown. 

• CRRP3: if dstLength is grater than the length of the simple TLV List, an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException. OUT_OF_TLV_BOUNDARIES. 

6.2.4.8. 1 .3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

6.2.4.8.2 Test Suite files 



Specific triggering: None 



Test Script: 


API. 


_2_ 


_ENH_ 


COPY. 


_BSS_ 


_l.scr 


Test Applet: 


API. 


.2. 


ENH 


.COPY. 


BSS. 


.l.java 


Load Script: 


APT 


.2. 


ENH. 


.COPY. 


BSS. 


.l.ldr 


Cleanup Script: 


APT 


.2. 


ENH. 


.COPY. 


BSS. 


.l.ch 
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Parameter File: API_2_ENH_COPY_BSS_l.par 



6.2.4.8.3 Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


NULL as parameter to dstBuffer 


NullPointerException is thrown 




2 


dstOffset ^ dstBuffer.length 

dstBuff er . length = 5 
dstOffset = 5 
dstLength = 1 


ArraylndexOutOfBoundsException is 
tlirown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 

dstLsngth = 1 


ArraylndexOutOfBoundsException is 
thrown 




4 


dstLength > dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 
d-stLength = 6 


ArraylndexOutOfBoundsException is 
thrown 




5 


DstOffset + dstLength > dstBuffer.length 

DstBuffer.length = 5 
DstOffset = 3 
DstLength = 3 


ArraylndexOutOfBoundsException is 
thrown 




6 


dstLength < 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsException is 
thrown 




7 


DstLength > length of the simple TLV list 

DstBuffer.length = 48 

DstOffset = 
DstLength = 48 


ToolkitException.OUT OF TLV BO 
UNDARIES is thrown 




8 


Successful call, dstBuffer is the whole buffer 

DstBuffer.length = 47 
DstOffset = 
DstLength = 47 


Result of copyO is 0X0047 




9 


Compare the buffer 


Result of arrayCompareO is 




10 


Successful call, dstBuffer is part of a buffer 

DstBuffer.length = 50 
dstOffset = 3 
dstLength = 47 


Result of copyO is 0X0032 




11 


Compare the whole buffer 


Result of arrayCompareO is 




12 


Successful call, dstBuffer Is part of a buffer 

dstBuffer.length = 15 
dstOffset = 3 
dstLength = 6 


Result of copyO is 0X0009 




13 


Compare the whole buffer 


Result of arrayCompareO is 




14 


Successful call, dstBuffer is part of a buffer 

dstBuffer.length = 250 
dstOffset = 257 
dstLength = 3 


Result of copyO is 0X01 04 




15 


Compare the whole buffer 


Result of arrayCompareO is 




16 


Successful call, copy with length =0 

dstBuffer.length = 260 
dstOffset = 260 
dstLength = 


Result of copyO is 0x1 04 





6.2.4.8.4 Test Coverage 



CRR number 


Test case number 


N1 


9, 11, 13, 15 


N2 


8, 10, 12, 14, 16 


PI 


1 


P2 


2, 3, 4, 5, 6 


P3 


7 


CI 


Does not apply for EnvelopeHandler 
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6.2.4.9 Method findTLV 

Test Area Reference: API_2_ENH_FINDBB. 
6.2.4.9.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

public byte findTLV (byte tag, byte occurrence) 
throws ToolkitException 

6.2.4.9.1.1 Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of the TLV Ust (handler buffer): 

• CRRNl: the method is successful if the required occurrence exists then the corresponding TLV becomes current. 

• CRRN2: if the method is successful then it returns TLV_FOUND_CR_SET when Comprehension Required flag 
is set. 

• CRRN3: if the method is successful then it returns TLV_FOUm)_CR_NOT_SET when Comprehension 
Required flag is not set. 

• CRRN4: if the required occurrence of the TLV element does not exist, the current TLV is no longer defined and 

TLV_NOT_FOUND is returned. 

• CRRN5: The search method is comprehension required flag independent. 

6.2.4.9. 1 .2 Parameter errors 

• CRRPl : if an input parameter is not vahd (e.g. occurrence = 0) an instance of ToolkitException shall be thrown. 
The reason code shall be ToolkitException BAD_INPUT_PARAMETER. 



6.2.4.9.1.3 



Context errors 



• CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

6.2.4.9.2 Test Suite files 

Specific triggering: None 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.4.9.3 



API_2_ENH_ENH_FINDBB_Lscr 
API_2_ENH_ENH_FINDBB_1 .Java 
API_2_ENH_ENH_FINDBB_1 .Idr 
API_2_ENH_FINDBB_1 .ck 
API_2_ENH_FINDBB_1 .par 

Test Procedure 



id 


Description 


API Expectation 


APDU Expectation 




Trig the applet with SMS PP including one more 
tag 02 and one TAG 04 






1 


Invalid Input parameter 

Occurrence = 


ToolkitException. BAD_INPUT_PA 
RAIVIETER is thrown 




2 


Search 1st TLV 

Tag = 02h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




3 


Call the getValueLengthQ method 


Result is 0x02 
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Id 


Description 


API Expectation 


APDU Expectation 


4 


Search 2nd TLV 

Tag = 06h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




5 


Call the getValueLengthO method 


Result is 0x05h 




6 


Select a TLV (tag 02h) 








Search a wrong tag 

Tag - 3h 


Result is TLV_NOT_FOUND 




7 


Call the getValueLengthO method 


ToolkitException.UNAVAILABLE_ 
ELEMENT is thrown. 




8 


Search a tag with wrong occurrence 

Tag = 02h 
Occurrence = 3 


Result is TLV_NOT_FOUND 




9 


Call the getValueLengthO method 


ToolkltException . UNAVAI LABLE_ 
ELEMENT is thrown. 




10 


Search the TLV 

Tag = 02h 
Occurrence = 2 


Result Is 

Tl \/ FDI IMF! PR MOT QFT 




11 


Search the TLV 

Tag = 04h 
Occurrence = 1 


Result is 

TLV FOUND CR NOT SET 




12 


Search tag 81 h 

Tag = 86h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




13 


Search tag 84h 

Tag = 84h 
Occurrence = 1 


F^6SLilt is 

TLV_FOUND_CR_NOT_SET 





6.2.4.9.4 Test Coverage 



CRR number 


Test case number 


N1 


3, 5 


N2 


2, 4 


N3 


10, 11 


N4 


6, 7,8, 9 


N5 


12, 13 


PI 


1 


CI 


Does not apply for EnvelopeHandler 



6.2.4.10 Method getValueLength 

Test Area Reference: API_2_ENH_GVLE. 
6.2.4.10.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

public short getValueLengthO 

throws ToolkltException 

6.2.4.10.1.1 Normal execution 

• CRRNl : gets and returns the binary length of the value field for the last TLV element which has been foimd in 
the handler. 

6.2.4.10.1.2 Parameter errors 

No requirements. 

6.2.4.10.1.3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkltException shall be thrown. The reason code shall be 
ToolkltException HANDLER_NOT_AVAILABLE. 
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• CRRC2: in case of unavailable TLV element an instance of TooUdtException shall be thrown. The reason code 
shall be TooUdtException UNAVAILABLE_ELEMENT. 

6.2.4.10.2 Test Suite files 



Specific triggering: None 



Test Script: 


API_ 


_2_ 


_ENH_ 


_GVLE_ 


_l.scr 


Test Applet: 


API_ 


_2_ 


_ENH_ 


_GVLE_ 


_l.java 


Load Script: 


API_ 


_2_ 


_ENH_ 


_GVLE_ 


_l.ldr 


Cleanup Script: 


API. 


.2. 


ENH. 


.GVLE. 


.l.cb- 


Parameter File: 


API. 


.2. 


ENH. 


.GVLE. 


.l.par 



6.2.4.10.3 Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Fill the SMS PP with TLV: Tag 33, Length C8 






1 


getValueLengtliQ 


ToolkitException . UNAVAI LABLE 
ELEMENT is thrown 




2 


Search TLV 02h 








getValueLength ( ) 


Result is 0X0002 




3 


Search TLV OBh 








getValueLength ( ) 


Result is 0X0024 




4 


Search TLV 33h 








getValueLength ( ) 


Result is 0X00C8 





6.2.4.10.4 Test Coverage 



CRR number 


Test case number 


N1 


2, 3, 4 


C1 


Does not apply for EnvelopeHandler 


C2 


1 



6.2.4.11 Method getValueByte 

Test Area Reference: API_2_ENH_GVBYS. 
6.2.4.11.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getValueByte (short valueOffset) 
throws ToolkitException 

6.2.4.1 1.1.1 Normal execution 

• CRRNl : Gets a byte from the last TLV element which has been found in the handler and returns its value 
(1 byte). 

6.2.4.11.1.2 Parameter errors 

• CRRPl : if valueOffset is out of the current TLV an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 
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6.2.4.1 1 .1 .3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code 
shall be ToolkitException UNAVAILABLE_ELEMENT. 

6.2.4.11.2 Test Suite files 



Specific triggering: None 



Test Script: 


API. 


.2. 


ENH. 


.GVBYS. 


.l.scr 


Test Applet: 


API_ 


_2_ 


_ENH_ 


_GVBYS_ 


_l.java 


Load Script: 


API_ 


_2_ 


_ENH_ 


_GVBYS_ 


J.dr 


Cleanup Script: 


API. 


.2. 


ENH. 


.GVBYS. 


.l.clr 


Parameter File: 


API. 


.2. 


ENH. 


.GVBYS. 


.l.par 



6.2.4.1 1 .3 Test Procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Fill the SMS PP with TLV: Tag 33, Length C8 
Valued 02 ... 






1 


getValueByte(O) 


ToolkitException.UNAVAILABLE_ 
ELEIVIENT is thrown 




2 


Search TLV 02h 








getValueByte (2) 


ToolkitException. OUT OF TLV 
BOUNDARIES is thrown 




3 


Search TLV 02h 








getValueByte (1) 


Result is 0x81 




4 


Search TLV 02h (Device Identities TLV) 








getValueByte (0) 


Result is 83h (Source) 




5 


Search TLV 33h 








getValueByte (7E) 


Result is 0x7F 




6 


Search TLV 33h 








getValueByte (80) 


Result is 0x81 




7 


getValueByte (7F) 


Result is 0x80 




8 


Search TLV B3h 








getValueByte (C7) 


Result is 0xC8 





6.2.4.1 1 .4 Test Coverage 



CRR number 


Test case number 


N1 


3, 4, 5, 6, 7, 8 


P1 


2 


C1 


Does not apply for EnvelopeHandler 


C2 


1 



6.2.4.12 Method copyValue 

Test Area Reference: API_2_ENH_CPYVS_BSS. 
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6.2.4.12.1 Conformance Requirement 

The method with following header shaU be compliant with its definition in the API. 

public short copyValue ( short valueOffset, 

byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws java . lang . NullPointerException, 

java . lang . ArraylndexOutOf BoundsException, 
ToolkitException 

6.2.4.12.1.1 Normal execution 

• CRRNl: copies a part of the last TLV element which has been found, into a destination, buffer. 

• CRRN2: returns dstOffset + dstLength. 

6.2.4.12.1 .2 Parameter errors 

• CRRPl: if dstBuffer is null NullPointerException is thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException is thrown. 

• CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

6.2.4.12.1.3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_A VAIL ABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code 
shall be ToolkitException UNAVAILABLE_ELEMENT. 

6.2.4.12.2 Test Suite files 



Specific triggering: None 



Test Script: 


API. 


.2. 


ENH. 


.CPYVS. 


.BSS. 


.l.scr 


Test Applet: 


API. 


.2. 


ENH. 


.CPYVS. 


.BSS. 


.l.java 


Load Script: 


API. 


.2. 


ENH. 


.CPYVS. 


BSS. 


.l.ldr 


Cleanup Script: 


API. 


_2_ 


_ENH_ 


_CPYVS_ 


_BSS_ 


_l.ch 


Parameter File: 


API. 


.2. 


ENH. 


.CPYVS. 


-BSS. 


.l.par 



6.2.4.12.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Search TLV 02h 








copyValue with a null dstBuffer 


NullPointerException is thrown 




2 


Search TLV OBh 








dstOffset > dstBuffer.length 

dstBuff er . length = 5 
dstOffset = 5 
dstLength = 1 


ArraylndexOutOf BoundsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOf BoundsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


A 


Hctl onnth ^HctRiiffor lonnth 
uoi^ciiyiii ^uoiDui Id .Id ly 11 1 

dstBuff er . length = 5 

dstOffset = 

dstLength = 6 


ttl 1 ay II lUcAv-'UL'^l DUUi IUoCXLfU)JLIU 

n is thrown 




C 
O 


Hctr^ffcat J. Hctl An/ith ^HotRiiffAi* lAn/ith 
Uoiv^iiocl + UolLciiyiii >iJaiDUiicr.iciiyiii 

dstBuff er . length = 5 

dstOffset = 3 

dstLength = 3 


Ml idyll lUcX^UL^^I DUUf lUbCXOUpLIU 

n ic thrniA/n 
1 1 lo 11 II uwi 1 




6 


dstLength < 

dstBuff er . length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n thrnwn 

1 1 10 11 II UWI 1 




7 


Search TLV 06h 








valueOffset > TLV Length 

valueOffset ^ 6 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 






dstBuf f er . length — 15 








dstOffset = 








dstLength = 1 






8 


valueOffset < 

valueOffset = -1 

H c -h R n -F -F 1" 1 £:inrr-|- Vi — 1 

CIS L ij u -L -L e X .xciiyiLii — -lo 
dstOffset = 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


dstLength > TLV length 

valueOffset = 
ds tBu f fer . length = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + dstLength > TLV length 

valueOffset = 2 
dstBuf fer . length = 15 

dstOffset - 
dsu^enguri 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Search TLV 01 h 








copyValue ( ) 


ToolkitException.UNAVAILABLE_ 
ELEMENT is thrown on the 
copyValueO method 




12 


Search TLV 06h 








Successful call 


Result of copyValueQ is 0x0006 






valueOffset = 








dstBuf fer . length = 6 
dstOffset = 








dstLength = 6 






13 


Compare buffer 

buffer = 81 11 22 33 44 F5 


Result is OOh 




14 


initialize dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 


Result of copyValueO is 0x0007 






valueOffset = 1 








dstBuf fer . length = 20 








dStOrrset — 








dstLength = 4 






15 


Compare buffer 

buffer = 
55 55 55 11 22 
33 44 55 55 55 
55 55 55 55 55 

55 55 55 55 55 


Result is OOh 




16 


Successful call, copy with length =0 

dstBuffer. length = 20 
dstOffset = 20 
dstLength = 


Result of copyValueO is 20 
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CRR number 


Test case number 


N1 


13, 15 


N2 


12, 14, 16 


PI 


1 


P2 


2, 3, 4, 5, 6 


P3 


7, 8, 9, 10 


CI 


Does not apply for EnvelopeHandler 


C2 


11 



6.2.4.13 Method compareValue 

Test Area Reference: API_2_ENH_CPRVS_BSS. 

6.2.4.13.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte compareValue (short valueOffset, 

byte [ ] compareBuf fer, 
short compareOf f set, 
short compareLength) 
throws java . lang .NullPointerException, 

java . lang .Array IndexOutOfBoundsExcept ion, 
ToolkitException 

6.2.4.13.1.1 Normal execution 
Compares the last found TLV element with a buffer: 

• CRRNl : returns if identical. 

• CRRN2: returns -1 if the first miscomparing byte in simple TLV List is less than that in compareBuffer. 

• CRRN3: returns 1 if the first miscomparing byte in simple TLV List is greater than that in compareBuffer. 

6.2.4.13.1 .2 Parameter errors 

• CRRPl: if compareBuffer is nuU NullPointerException shall be thrown. 

• CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if 
compareLength is negative ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

6.2.4.13.1.3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code 
shaU be ToolkitException UNAVAILABLE_ELEMENT. 

6.2.4.13.2 Test Suite files 

Specific triggering: None 

Test Script: API_2_ENH_CPRVS_BSS_Lscr 
Test Applet: API_2_ENH_CPRVS_BSS_Ljava 
Load Script: API_2_ENH_CPRVS_BSS_l.ldr 
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Cleanup Script: API_2_ENH_CPRVS_BSS_l.clr 
Parameter File: API_2_ENH_CPRVS_BSS_1 .par 



6.2.4.13.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Search TLV 02h 








cornp9.irsV3lus ( ) with cl null cornpsirsBuf f sir 


iNuiir uiruci cxocpuuri Ib LlirUWil 




2 


Search TLV OBh 








compareOffset > compareBuffer.length 

compareBuff er . length = 5 
compareOffset = 5 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

compareBuffer.length = 5 
compareOffset = ~1 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareLength >compareBuffer.length 

compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


comnareOffset *■ comnareLencith 
>compareBuffer.iength 

compareBuffer.length = 5 
compareOffset = 3 
compareLength = 3 


ArrflvlnripyOi itOfRni inri<;FYrpntin 
n is thrown 




e 
D 


i#uiii|jcircLciiy III < u 

compareBuffer.length = 5 
compareOffset = 
compareLength = -1 


Ml Idyll lUoXVJUL'^l DUUllUbCXOUpLIU 

n is thrown 




7 


Search TLV 06h 








valueOffset ^ TLV Length 

valueOffset = 6 
compareBuffer.length = 15 

compareOffset - 
compdre^engun 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


ToolkitException.OUT_OF_TLV_ 
BOUNDARIES is thrown 




9 


compareLength > TLV length 

valueOffset = 
compareBuffer.length = 15 
compareOffset = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + compareLength > TLV length 

valueOffset = 2 
compareBuffer.length = 15 
compareOffset = 
compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Search TLV 01 h 


Result is TLV NOT FOUND 






compareValue ( ) 


ToolkitException . UNAVAI LABLE_ 
ELEIVIENT is thrown 




12 


Search TLV 06h 








Initialize compareBuffer 

compareBuff er = 
81 11 22 33 44 F5 








Compare buffers 

valueOffset = 
compareOffset = 
compareLength = 6 


Result is OOh 




13 


Initialize compareBuffer 

compareBuffer = 

7F 11 22 33 44 F5 








Compare buffers with same parameters 


Result is -1 




14 


Initialize compareBuffer 

compareBuffer = 
83 11 22 33 44 F5 








Compare buffers with same parameters 


Result is -1 
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Id 


Description 


API Expectation 


APDU Expectation 


-1 ^ 


inillall26 COinparcDUTTcr 

compareBuf f er = 

55 55 55 81 11 22 33 44 F5 

55 55 55 55 55 








v^oiTipare Duners 

valusOf f sst — 1 
compareOf f set = 4 
compareLength = 5 


riesuii IS uun 




16 


Initialize compareBuffer 

coiTipar"eBu f f er" = 

55 55 55 81 10 22 33 44 F5 

55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 




17 


Initialize compareBuffer 

compareBuffer = 

55 55 55 81 12 22 33 44 F5 

55 55 55 55 55 








Compare buffers with same parameters 


Result is -1 




18 


Successful call, compareVaiue with length =o 

CompareBuf fer . length = 15 
CompareOf f set = 15 
CompareLength = 


Resuit of compareValueO is 





6.2.4.13.4 Test Coverage 



CRR number 


Test case number 


N1 


12, 15 


N2 


13, 16, 18 


N3 


14, 17 


PI 


1 


P2 


2, 3, 4, 5, 6 


P3 


7, 8, 9, 10 


CI 


Does not apply for EnvelopeHandler 


C2 


11 



6.2.4.14 Method findAndCopyValue(byte tag, byte[] dstBuffer, short dstOffset) 

Test Area Reference: API_2_ENH_FACYB_BS. 
6.2.4.14.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short f IndAndCopyValue (byte tag, 

byte[] dstBuffer, 

short dstOffset) 
throws java . lang .NullPointerException, 
java . lang .Array IndexOutOfBoundsExcept ion, 

ToolkitException 

6.2.4.14.1.1 Normal execution 

• CRRN 1 : looks for the first occurrence of a TLV element from the beginning of a TLV list and copy its value into 
a destination buffer. 

• CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + length of the 
copied value is returned. 

• CRRN4: The search method is comprehension required flag independent. 
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6.2.4.14.1 .2 Parameter errors 

• CRRPl : if dstBuffer is null NullPointerException shaU be thrown. 

• CRRP2: if dstOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall be 
thrown. 



6.2.4.14.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitExceptionHANDLER_NOT_AVAILABLE. 

6.2.4.14.2 Test Suite files 

Specific triggering: None 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.4.14.3 



API_2_ENH_FACYB_BS_1 .scr 
API_2_ENH_FACYB_BS_1 .Java 
API_2_ENH_FACYB_BS_1 .Idr 
API_2_ENH_FACYB_BS_1 .clr 
API_2_ENH_FAC YB_BS_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Fill the SMS PP with TLV: Tag 02 Value 22 44 
Tag 33, Length C4 Value 01 02 ... 






1 


FindAndCopyValueO with a null dstBuffer 


NullPointerException is thrown 




2 


dstOffset > dstBuffer.length 

tag = 06h 

dstBuffer.length = 06 
dstOffset = 06 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 06 
dstOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > dstBuffer.length 

dstBuffer.length = 05 
dstOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


DstOffset + length >dstBuffer. length 

DstBuffer.length = 06 
DstOffset = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


Select a TLV (tag 02h) 








findAndCopyValueO 

tag = 03h 


ToolkitException. UNAVAILABLE 
ELEMENT is thrown 






Call the getValueLengthO method 


ToolkitException . UNAVAI LABLE 
ELEMENT is thrown. 




7 


Successful call 

Tag = 06h 

DstBuffer.length = 06 
DstOffset = 


Result of findAndCopyValue () is 
0006 




8 


Compare buffer 

buffer = 81 11 22 33 44 F5 


Result is OOh 




9 


Initialize dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

d = ^Ruff . length - 12 
dstOffset 2 


Result of findAndCopyValue () is 

0008 




10 


Compare buffer 

buffer = 

55 55 81 11 22 33 44 F5 55 55 55 55 


Result is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


11 


Successful call 

tag = 02h 

dstBuff er . length = 2 
dstOffset = 


Result of findAndCopyValue {) is 
0002 




12 


Compare buffer 

buffer = 83 81 


Result is OOh 




13 


Successful call (with tag 82h) 

tag = 82h 

dstBuff er . length = 02 
dstOffset = 


Result of findAndCopyValue () is 
0002 




14 


Compare buffer 

buffer ci J ci 1 


Result is OOh 




15 


Successful call (with tag B3h) 

tag = B3h 

dstBuffer. length = C4 
dstOffset = 


Result of findAndCopyValue () is 
00C4 




16 


Compare buffer 

buffer = 01 02 ... C4 


Result is OOh 





6.2.4.14.4 Test Coverage 



CRR number 


Test case number 


N1 


8, 10, 12 


N2 


6 


N3 


7, 9, 11 


N4 


13, 14, 15, 16 


PI 


1 


P2 


2, 3, 4, 5 


CI 


Does not apply for EnvelopeHandler 



6.2.4.15 Method findAndCopyValue(byte tag, byte occurrence, short valueOffset, 
byte[] dstBuffer, short dstOffset, short dstLength) 

Test Area Reference: API_2_ENH_FACYBS_BSS. 
6.2.4.15.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short findAndCopyValue (byte tag, 

byte occurence, 
short valueOffset, 
byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws java . lang .NullPointerException, 

java . lang .Array IndexOutOfBoundsExcept ion, 
ToolkitException 

6.2.4.15.1.1 Normal execution 

• CRRNl : looks for the indicated occurrence of a TLV element from the beginning of a TLV Ust and copy its 
value into a destination buffer. 

• CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + dstLength is 
returned. 

• CRRN4: The search method is comprehension required flag independent. 
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6.2.4.15.1 .2 Parameter errors 

• CRRPl : if dstBuffer is null NullPointerException shaU be thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 



6.2.4.15.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 



6.2.4.15.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.4.15.3 



Test Suite files 

API_2_ENH_FAC YBS_BSS_1 .scr 
API_2_ENH_FACYBS_BSS_1 .java 
API_2_ENH_FACYBS_BSS_1 .Idr 
API_2_ENH_FACYBS_BSS_1 .ck 
API_2_ENH_FACYBS_BSS_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 




FIN the SMS PP with TLV: Tag 02 Value 22 44 
Tag 33, Length C4 Value 01 02 ... 






1 


findAndCopyValueO with a null dstBuffer 


NullPointerException is thrown 




2 


dstOffset ^ dstBuffer.length 

tag = 06h, occurrence = 1 
valueOffset = 
dstBuffer.length = 5 
dstOffset = 5 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 5 

dstOffset = -1 
dstLength = 1 


Array 1 ndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength >dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength >dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


valueOffset ^ Value Length 

tag = 06h, occurrence = 1 
valueOffset = 6 
dstBuffer.length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
dstBuffer.length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


9 


dstLength > Value length 

valueOffset = 
ds tBu f fer . length = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + dstLength > Text String length 

valueOffset — 2 
dstBuff er . length = 15 
dstOffset = 
dstLength = 5 


ToolkitException.OUT_OF_TLV_ 

RDI IMRARIF"^ i<; thrnvun 

EJWI.J IML^/AAPlI lo LIIIUWII 




11 


Select a TLV (tag 02h) 








findAndCopyVaiueO 

tag = 06h 


Tooll<ltException.UNAVAII-ABLE 
ELEMENT is tiirown 






occurrence = 2 








r^flll thp nptVflliipLpnnthn mpthnrl 


TnnlkitFyrpntinn 1 IMAVAII ARI F 

1 \JU 1 i\l L^AUCUll Ui 1 . 1 NrA V m 1 /\ LJL_ 1 

ELEMENT is thrown. 




i O 
\ d. 


ouccessTui call 

tag = 06h, occurrence = 1 
valueOffset = 
dstBuff er . length = 06 
dstOffset = 
dstLength = 06 


riesuii or TinoMnaLiopy vaiue^; is o 




13 


ComDare buffer 

hnf for = 81 11 ?? 44 


Rpcijlt ic OOh 






iniiiaiize usiDUTTer 

dstBuffer = 55 55 ... 55 








Successful call 


Result of findAndCopyValue {) is 






tag = 06h, occurrence = 1 


0007 






valueOffset = 2 








dstBuffer . length = 12 








dstOffset = 3 








dstLength =04 






15 


Compare buffer 

buffer = 

55 55 55 22 33 44 F5 55 55 55 55 55 


Result is OOh 




\ D 


OUCCeSSTUI Call 

tag = 02h, occurrence = 1 
valueOffset = 
dstBuff er . length = 12 
dstOffset = 
dstLength = 2 


riesuii or rina/\naLiOpyvaiue(; is 
0002 




-1 -7 


uornpare uUTrer 

buffer = 83 81 55 ... 55 


riesuiT IS uun 




\ o 


ouccessTui can 

tag = 02h, occurrence = 2 
valueOffset = 
dstBuffer. length = 12 
dstOffset = 
dstLength = 2 


riesuii or rinoMnauopy vaiuey is 
0002 




19 


Compare buffer 

Durrer — zz 44 ... bb 


Result is OOh 




20 


Successful call (with tag 82h) 

tag = 82h 
occurrence = 1 
valueOffset = 
dstBuffer . length = 12 
dstOffset = 
dstLength = 02 


Result of findAndCopyValue () is 
0002 




21 


Compare buffer 

Du xter — oJ ol oo ... oo 


Result is OOh 




22 


Successful call (with tag 82h) 

occurrence = 2 
valueOffset = 
dstBuffer. length = 12 

dstOffset = 
dstLength = 02 


Result of findAndCopyValue {) is 




23 


Compare buffer 

Buffer = 22 44 55 ... 55 


Result is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


24 


Successful call, findAndCopyValue with length 
=0 

DstBuffer . length = 12 
dstOffset = 12 
dstLength = 


Result of findAndCopyValue {) Is 
12 





6.2.4.15.4 Test Coverage 



CRR number 


Test case number 


N1 


13, 15, 17, 19 


N2 


11 


N3 


12, 14, 16, 18, 24 


N4 


20, 21 , 22, 23 


PI 


1 


P2 


2, 3, 4, 5, 6 


P3 


7, 8, 9, 10 


CI 


Does not apply for EnvelopeHandler 



6.2.4.16 Method findAndCompareValue(byte tag, byte[] compareBuffer, short 
compareOffset) 

Test Area Reference: API_2_ENH_FACRB_BS. 
6.2.4.16.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte f indAndCompareValue (byte tag, 

byte [ ] compareBuffer, 
short compareOffset) 
throws java . lang . NullPointerException, 

java . lang . ArraylndexOutOf BoundsException, 
ToolkitException 

6.2.4.16.1.1 Normal execution 

Looks for the first occurrence of a TLV element from beginning of a TLV list and compare its value with a buffer: 

• CRRN 1 : if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN2: if the method is successful then the corresponding TLV becomes current. 

• CRRN3 : if identical returns 0. 

• CRRN4: if the first miscomparing byte in simple TLV is less than that in compareBuffer returns -L 

• CRRN5: if the first miscomparing byte in simple TLV is greater than that in compareBuffer returns L 

• CRRN6: The search method is comprehension required flag independent. 

6.2.4.16.1.2 Parameter errors 

• CRRPl: if compareBuffer is nuU NullPointerException shall be thrown. 

• CRRP2: if compareOffset would cause access outside array boimds ArraylndexOutOfBoimdsException shall be 
thrown. 
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6.2.4.16.1 .3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 



6.2.4.16.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.4.16.3 



Test Suite files 

API_2_ENH_FACRB_BS_1 .scr 
API_2_ENH_FACRB_BS_1 .Java 
API_2_ENH_FACRB_BS_1 .Idr 
API_2_ENH_FACRB_BS_1 .ck 
API_2_ENH_FACRB_BS_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Fili the SMS PP with TLV: Tag 02 Value 22 44 
Tag 33, Length C4 Value 01 02 ... 






1 


findAndCompareValueO with a null dstBuffer 


NullPointerException is thrown 




2 


compareOffset ^ compareBuffer.length 

tag = 06h 

compareBuffer.length = 12 
compareOffset = 12 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

compareBuffer.length = 12 
compareOffset = -1 


Array 1 ndexOutOfBoundsExceptio 

n is thrown 




4 


length > compareBuffer.length 

compareBuffer.length = 05 
compareOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + length > 
compareBuffer.length 

compareBuffer.length = 12 
compareOffset = 7 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


Select a TLV (tag 02h) 








findAndCompareValueO 

tag = 03h 


Tooll<itException.UNAVAII_ABLE_ 
ELEIVIENT is thrown 






Call the getValueLengthO method 


Tooll<itException . UNAVAI l_ABLE_ 
ELEMENT is thrown. 




7 


Initialize compareBuffer 

compareBuf fer = 81 11 22 33 44 F5 








Compare buffers 

tag = 06h 
compareOffset = 


Result is OOh 










8 


Verify current TLV 

getValueLength ( ) 


Result is 06 




9 


Initialize compareBuffer 

compareBuffer = 81 11 22 33 44 F4 








Compare buffers with same parameters 


Result is +1 




10 


initialize compareBuffer 

compareBuffer = 81 11 22 33 44 F6 








Compare buffers with same parameters 


Result is -1 




11 


Initialize compareBuffer 

compareBuffer = 

55 55 81 11 22 33 44 F5 55 55 55 55 








Compare buffers 

compareOffset = 2 


Result is OOh 




12 


Initialize compareBuffer 

compareBuffer = 

55 55 83 81 55 55 55 55 55 55 55 55 








Compare buffers 

compareOffset = 2 


Result is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


13 


Initialize compareBuffer 

compareBuf f er = 

55 55 83 80 55 55 55 55 55 55 55 55 






Compare buffers 

compareOf f set = 2 


Result is +1 




14 


Initialize compareBuffer 

compareBuffer = 

55 55 83 82 55 55 55 55 55 55 55 55 






Compare buffers 

c c nip o. ji s f f s s L. z 


Result is -1 




15 




Initialize compareBuffer 

COmpSlTSB'uf f SIT = 

83 81 55 55 55 55 55 55 55 55 55 55 






Successful call (with tag 02h) 

tag = 02h 

compareBuf fer . length = 12 
compareOf f set = 


Result is OOli 




16 


Initialize compareBuffer 

CompareBuffer = 01 02 ... C4 








Successful call (with tag B3h) 

Tag = B3h 

CompareBuf fer . length = C4 
CompareOf f set = 


Result is OOh 





6.2.4.16.4 Test Coverage 



CRR number 


Test case number 


N1 


6 


N2 


8 


N3 


7, 11, 12 


N4 


9, 13 


N5 


10, 14 


N6 


15, 16 


PI 


1 


P2 


2, 3, 4, 5 


C1 


Does not apply for EnvelopeHandler 



6.2.4.17 Method findAndCompareValue(byte tag, byte occurrence, short valueOffset, 
byte[] compareBuffer, short compareOffset, short compareLength) 

Test Area Reference: API_2_ENH_FACRBBS_BSS. 
6.2.4.17.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte f indAndCompareValue (byte tag, 

byte occurence, 
short valueOffset, 
byte [ ] compareBuffer, 
short compareOffset, 
short compareLength) 
throws java . lang . NullPointerException, 

java . lang .Array IndexOutOfBoundsExcept ion. 
Toolkit Except ion 

6.2.4.17.1.1 Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of a TLV Ust and compare its value with a 
buffer: 

• CRRN 1 : if no TLV element is found, the UN AV AILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN2: if the method is successful then the corresponding TLV becomes current. 
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• CRRN3: if identical is returned. 

• CRRN4: if the first miscomparing byte in simple TLV is less than that in compareBuffer -1 is returned. 

• CRRN5: if the first miscomparing byte in simple TLV is greater than that in compareBuffer 1 is returned 

• CRRN6: The search method is comprehension required flag independent. 

6.2.4.17.1 .2 Parameter errors 

• CRRPl: if compareBuffer is nuU NullPointerException shall be thrown. 

• CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if 
compareLength is negative ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: if valueOffset, compareLength or both are out of the current TLV an instance of TooUdtException shall 
be thrown. The reason code shall be TooUdtException OUT_OF_TLV_BOUND ARIES. 

• CRRP4: if an input parameter is not valid (e.g. occurence = 0) an instance of TooUdtException shall be thrown. 
The reason code shall be TooUdtException BAD_INPUT_PARAMETER. 

6.2.4.17.1 .3 Context errors 

• CRRCl : if the handler is busy an instance of TooUdtException shall be thrown. The reason code shall be 
TooUdtException HANDLER_NOT_AVAILABLE. 



6.2.4.17.2 Test Suite files 



Test Script: 


APL 


_2_ 


_ENH_ 


_FACRBBS_ 


_BSS_ 


_l.scr 


Test Applet: 


API. 


_2_ 


_ENH_ 


_FACRBBS_ 


_BSS_ 


_l.java 


Load Script: 


API. 


.2. 


ENH. 


.FACRBBS. 


.BSS. 


.l.ldr 


Cleanup Script: 


API. 


.2. 


ENH. 


.FACRBBS. 


.BSS. 


.l.clr 


Parameter File: 


API. 


.2. 


ENH. 


.FACRBBS. 


.BSS. 


.l.par 



6.2.4.17.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Fill the SMS PP with TLV: Tag 02 Value 22 44 
Tag 33, Length C4 Value 01 02 ... 






1 


findAndCompareValueO with a null 
compareBuffer 


NullPointerException is thrown 




2 


compareOffset > compareBuffer.length 

tag ^ 06h, occurrence = 1 
valueOffset = 
compareBuffer.length = 6 
compareOffset = 5 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

compareBuffer.length = 6 
compareOffset = -1 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareLength >compareBuffer.length 

compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + compareLength 
>compareBuffer.length 

compareBuffer.length = 5 
compareOffset = 3 
compareLength = 3 


Array 1 ndexOutOfBoundsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


6 


compareLength < 

compareBuff er . length = 5 

L. UUl^d I. ^ ^ b fcr L — U 

compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


valueOffset > Value Length 

tag = 06h, occurrence = 1 
valueOffset = 6 
compar eBu f fer . length = 15 
compareOf f set = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
compareBuff er . length = 15 
compareOf f set = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


compareLength > Value length 

valueOffset = 
compareBuff er . length = 15 

compareOf f set = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + compareLength > Value length 

valueOffset = 2 
compareBuff er . length = 15 
compareOf f set = 
compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Invalid parameter 

occurrence = 


ToolkitException . BADJ N PUT_PA 
RAMETER is thrown 




12 


Select a TLV (tag 02h) 








fIndAndCompareValueO 

tag = 06h 


ToolkitException . UNAVAI LABLE 
ELEMENT is thrown 






occurrence = 2 








Call the getValueLengthO method 


ToolkitException. UNAVAILABLE_ 
ELEMENT is thrown. 




13 


Initialize compareBuffer 

compareBuff er = 81 11 22 33 44 F5 








fIndAndCompareValueO 

tag = 06h, occurrence = 1 


Result is OOh 






valueOffset = 








compareOf f set = 
compareLength = 6 






14 


Verify current TLV 

getValueLength ( ) 


Result is 0006 




15 


Initialize compareBuffer 

compareBuffer = 81 11 22 33 44 F4 








Compare buffers with same parameters 


Result is +1 




16 


Initialize compareBuffer 

compareBuffer = 81 11 22 33 44 F6 








Compare buffers with same parameters 


Result is -1 




17 


Initialize compareBuffer 

compareBuffer = 

55 55 55 22 33 44 F5 55 55 55 55 








Compare buffers 


Result is OOh 






valueOffset = 2 








compareOf f set = 3 








compareLength = 4 






18 


Initialize compareBuffer 

compareBuffer = 

55 55 55 22 33 45 F5 55 55 55 55 








Compare buffers with same parameters 


Result is -1 




19 


Initialize compareBuffer 

compareBuffer = 

55 55 55 22 33 43 F5 55 55 55 55 








Compare buffers with same parameters 


Result is +1 




20 


Initialize compareBuffer 

compareBuffer = 

83 81 55 55 55 55 55 55 55 55 55 55 








fIndAndCompareValueO 


Result is OOh 






tag = 02h, occurrence = 1 








valueOffset = 








compareOf f set = 
compareLength = 2 
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Id 


Description 


API Expectation 


APDU Expectation 


c. \ 


II IlllClll^t? i^UI 1 l^dl CDU 1 ici 

compareBuf f er = 

22 44 55 55 55 55 55 55 55 55 55 55 








1 11 lUMI lU wUlli|Jcll c V diUc^^ 








tag = 02h, occurrence = 2 








valueOffset = 








compa.reOf f set = 








compareLength = 2 






00 

C.C. 


Initi£ili70 ^mYmsaroRi iffor 

lllllldll^t? 1 I|JC1I CDU 1 Id 

compareBuf fer = 

22 45 55 55 55 55 55 55 55 55 55 55 








1 II lUnI lU wUI 1 lUdl C V dlUC^^ 

tag = 02h, occurrence = 2 


D 1 It io i 
ricbUIL Io 1 






valueOffset = 








cornpareOf f set = 
compareLength = 2 








Illllldll^C OUIIIUdlCDUIId 

compareBuf fer = 

83 81 55 55 55 55 55 55 55 55 55 55 








ir*r*aiccf 1 il r^all Ajuith ton ^0h^ 
OUOOc;ooiUl Udii ^Wllll Idy 


Poci lit ic nnh 






tag = 02h, occurrence = 1 








valueOffset = 








c omp a r eBu f f e r . length — 12 








compareOf f set = 








compareLength = 2 






OA 


lllllldll^t; l^ulllfJdicDUl Icl 

compareBuf fer = 01 02 ... C4 








Successful call (with tag B3h) 


Result is OOh 






tag = B3h, occurrence = 1 








valueOffset = 








compareBuf fer . length = 00C4 








compareOf f set = 
compareLength = 00C4 






25 


Successful call, fIndAndCompareValue with 
length =0 

DstBuf fer . length = C4 
DstOffset = C4 
DstLength = 


Result of findAndCompareValueQ 

is OOh 





6.2.4.17.4 Test Coverage 



CRR number 


Test case number 


N1 


12 


N2 


14 


N3 


13, 17, 20, 21, 25 


N4 


19, 15 


N5 


16, 18, 22 


N6 


23, 24 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7, 8, 9, 10 


P4 


11 


C1 


Does not apply for EnvelopeHandler 



6.2.5 Class EnvelopeResponseHandler 
6.2.5.1 Method getTheHandler 

Test Area Reference: API_2_ERH_GTHD. 
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6.2.5.1.1 Conformance requirement: 

The method with following header shaU be compliant to its definition in the API. 

public static EnvelopeResponseHandler getTheHandler ( ) 

throws ToolkitException 

6.2.5.1 .1 .1 Normal execution 

• CRRNl: The method shaU return the single system instance of the EnvelopeResponseHandler class. 

• CRRN2: The EnvelopeResponseHandler is a Temporary JCRE Entry Point Object ( see Javacard 2.1 Runtime 
Environment (JCRE) Specification [12]). 

6.2.5.1.1.2 Parameter errors 
No requirements. 

6.2.5.1 .1 .3 Context errors 

• CRRCl : The method shall thrown ToolkitException (HANDLER_NOT_AVAILABLE) if the handler is busy. 

• CRRC2: After the first invocation of the ProactiveHandler.send method the EnvelopeResponseHandler is no 
more available 



6.2.5.1.2 Test suite files 



Test Script: 


API. 


.2. 


ERH. 


.GTHD. 


.l.scr 


Test Applet: 


API. 


.2. 


ERH. 


.GTHD. 


.l.java 


Load Script: 


API. 


.2. 


ERH. 


.GTHD. 


.l.ldr 


Cleanup Script: 


API. 


.2. 


ERH. 


.GTHD. 


.l.clr 


Parameter File: 


API. 


.2. 


ERH. 


.GTHD. 


.l.par 



6.2.5.1.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


getTheHandler twice 


The returned objects shall be the 
same 




2 


Verify that getTheHandler returns an 
EnvelopeHandler 

getTheHandler 


The reference returned shall be an 

EnvelopeResponseHandler 

(checkcast) 




3 


Verify the returned value is not null 

getTheHandler 


The reference returned shall not be 
null. 




4 


getTheHandler, then send a proactive 
command, and then, appendTLV 


ToolkitException 
HANDLER_NOT_AVAILABLE is 
thrown 





6.2.5.1 .4 Test Coverage 



CRR number 


Test case number 


N1 


1, 2, 3 


N2 


To be checked in Framework tests and insert here cross reference 


CI 


To be checked in Framework tests and insert here cross reference 


02 


4 



6.2.5.2 Method post 

Test Area Reference: API_2_ERH_POSTB. 
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6.2.5.2.1 Conformance requirement 

The method with following header shaU be compliant to its definition in the API. 

public void post (byte statusType) 
throws ToolkitException 

6.2.5.2. 1 . 1 Normal execution 

• CRRNl: When the method is called, the toolkit applet can continue it's processing (e.g. prepare a proactive 
command). 

• CRRN2: The byte statusType is SWl of the status. 

• CRRN3: If the send method is called after a post method, the posted data are the first sent to the ME. 

• CRRN4: The SIM TooUdt Framework shall take the optional Application Data posted by the triggered toolkit 
applet if present, secure and send the response packet the SIM Toolkit Framework will return the response 
APDU defined by the toolkit applet. 

6.2.5.2. 1 .2 Parameter error 

No requirements. 

6.2.5.2.1.3 Context errors 

• CRRCl : The method shall thrown ToolkitException (HANDLER_NOT_AVAILABLE) if the handler is busy. 

6.2.5.2.2 Test suite files 

Specific triggering: Call control 



Test Script: 


API_ 


_2_ 


_ERH_ 


_POSTB_ 


_l.scr 


Test Applet: 


API. 


.2. 


ERH. 


.POSTB. 


.l.java 


Load Script: 


API. 


.2. 


ERH. 


.POSTB. 


.l.ldr 


Cleanup Script: 


API. 


.2. 


ERH. 


.POSTB. 


.l.clr 


Parameter File: 


API. 


.2. 


ERH. 


.POSTB. 


.l.par 
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6.2.5.2.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


getTheHandler and then post 

(the handler is empty) 




9000 


2 


Fill the handler ( appendTLV to have bytes 

in it ) and then post data with status 
9F 




9FFD data are retrieved with GET 
RESPONSE command 


3 


Verify that after a post the handler is no 
more available 

appendTLV, post and then appendTLV 


ToolkitException 
HANDLER_NOT_AVAILABL 
E is thrown on the second 
appendTLV 




4 


construct the response (appendTLV with 
0x10 data) and post it with status 9E and 
then send a display text 




9E12 and posted data retrieved by a 
GET RESPONSE with status 91 1 3 
and display text retrieved by a FETCH 


5 


Verify that it is possible to send a proactive 
command after a post 

getTheHandler and post , then send a 
display text 




91 13 and display text is retrieved by 
a FETCH 


6 


Verify it is not possible to post after a 
proactive command 

getTheHandler, appendTLV, send a 
display text, post. 


ToolkitException 
HANDLER_NOT_AVAILABL 
E is thrown 




7 


Verify that the handler is no more available 
after a post 

getTheHandler, appendTLV, post with 
status 9E, post with status 9F 


ToolkitException 
HANDLER_NOT_AVAILABL 
E is thrown 


9E12 and posted data retrieved by a 
GET RESPONSE 



6.2.5.2.4 Test Coverage 



GRR number 


Test case number 


N1 


3,4,7 


N2 


1, 2, 4, 7 


N3 


4, 5 


N4 


To be checked in Framework tests and insert here cross reference 


CI 


6 



6.2.5.3 Method postAsBERTLV 

Test Area Reference: API_2_ERH_POSTBB. 
6.2.5.3.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

public void postAsBERTLV (byte statusType, 

byte tag) 
throws ToolkitException 

6.2.5.3. 1 . 1 Normal execution 

• CRRNl: When the method is called, the toolkit applet can continue it's processing (e.g. prepare a proactive 
command) the SIM Toolkit Framework will return the response APDU defined by the toolkit applet. 

• CRRN2: The byte statusType is SWl of the status 

• CRRN3: If the send method is called after a postAsBERTLV method, the posted data are the first sent to the 
ME. 

• CRRN4: The byte tag is the BER Tag at the beginning of the simple TLV Ust. 

6.2.5.3.1.2 Parameter errors 
No requirements. 
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6.2.5.3. 1 .3 Context errors 

• CRRCl : The method shall thrown ToolkitException (HANDLER_NOT_AVAILABLE) if the handler is busy. 

6.2.5.3.2 Test suite files 



Specific triggering: Call control 



Test Script: 


API. 


.2. 


ERH. 


.POSTBB. 


.l.scr 


Test Applet: 


API. 


.2. 


ERH. 


.POSTBB. 


.l.java 


Load Script: 


API. 


.2. 


ERH. 


.POSTBB. 


.l.ldr 


Cleanup Script: 


API. 


.2. 


ERH. 


.POSTBB. 


.l.clr 


Parameter File: 


API. 


.2. 


ERH. 


.POSTBB. 


.l.par 



6.2.5.3.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


getlheHandler and then postAsBERTLV 

(the handler is empty) 




9F02 data are retrieved with 
GET RESPONSE command, 
the tag shall be 33 and the 
length Is 00 


2 


Fill the handler and then postAsBERTLV 
the data with status 9F, and tag 33 




9FFF data are retrieved with 
GET RESPONSE command, 
the tag shall be 33 


3 


appendlLV, postAsBERTLV and then 
appendTLV 


ToolkitException 
HANDLER_NOT_AVAILABLE Is 
thrown on the second appendTLV 




4 


construct the response (appendTLV with 

0x10 data) and postAsBERTLV it with 
status 9E, tag 75 and then send a display 
text 




9E14 and posted data 
retrieved by a GET 
RESPONSE the tag shall be 
75 with status 9113 and 
display text retrieved by a 
FETCH 


5 


getTheHandler and postAsBERTLV, then 
send a display text 




9E02 and posted data 
retrieved by a GET 
RESPONSE the tag 33 (and 
the length 00) with status 
91 13 and display text is 
retrieved by a FETCH 


6 


Verify it is not possible to postAsBERTLV 
after a proactive command 

getTheHandler, appendTLV, send a 
display text, postAsBERTLV. 


ToolkitException 
HANDLER_NOT_AVAILABLE Is 
thrown on the postAsBERTLV 




7 


Verify that the handler is no more available 
after a postAsBERTLV 

getTheHandler, appendTLV (with data 
length = 0x10, postAsBERTLV with status 
9E, tag 56, postAsBERTLV with status 
9F, tag 28 


ToolkitException 
HANDLER_N0T_AVA1LABLE is 
thrown on the second postAsBERTLV 


9E14 and posted data 
retrieved by a GET 
RESPONSE the tag shall be 
56 with status 9000 



6.2.5.3.4 Test Coverage 



CRR number 


Test case number 


N1 


3, 4, 7 


N2 


1, 2, 4, 7 


N3 


4, 5 


N4 


2, 4, 7 


CI 


6 
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6.2.5.4 Method getLength 

Test Area Reference: API_2_ERH_GLEN. 

6.2.5.4.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getLength () 

throws ToolkitException 

6.2.5.4. 1 . 1 Normal execution 

• CRRNl : returns the length in bytes of the TLV list. 

6.2.5.4. 1 .2 Parameter errors 

No requirements. 

6.2.5.4.1.3 Context errors 

• CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 

6.2.5.4.2 Test Suite files 



Specific triggering: Unrecognized Envelope 



Test Script: 


API. 


.2. 


ERH. 


.GLEN_ 


.l.scr 


Test Applet: 


API. 


.2. 


ERH. 


.GLEN_ 


.l.java 


Load Script: 


API. 


.2. 


_ERH. 


_GLEN_ 


_l.ldr 


Cleanup Script: 


API. 


.2. 


_ERH. 


_GLEN_ 


_l.ch 


Parameter File: 


API. 


.2. 


ERH. 


.GLEN_ 


.l.par 



6.2.5.4.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Clear the handler 

getLength ( ) 


Result of getLengthO is 




2 


appendTLV with length of 7 

getLength ( ) 


Result of getLengthO is 9 




3 


Clear the handler and appendTLV with Length 
of 250 

getLength ( ) 


Result of getLengthO is 253 




4 


Build a 7Fh Envelope response handler 

getLength ( ) 


Result of getLengthO is 81 h 




5 


Build a SOh Envelope response handler 

getLength ( ) 


Result of getLengthO is 83h 




NOTE: Test case 3 is limited to 253 and not 256 because tlie current GSM 03.1 9 [7] is not clear enough on this point. 
So this test allows the two possible implementations. 



6.2.5.4.4 Test Coverage 



CRR number 


Test case number 


N1 


1,2,3,4,5 


01 


Does not apply for Envelope response handler 
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6.2.5.5 



Method copy 



Test Area Reference: API_2_ERH_COPY_BSS. 



6.2.5.5.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 



public short copy (byte [] dstBuffer, 



short dstOffset, 
short dstLength) 



throws java . lang .NullPointerException, 

java . lang .Array IndexOutOfBoundsExcept ion, 
ToolkitException 



6.2.5.5.1.1 



Normal execution 



• CRRNl : copies the simple TLV Ust contained in the handler to the destination byte array. 



• CRRN2: returns dstOffset + dstLength. 



6.2.5.5.1.2 



Parameter errors 



• CRRP 1 : if dstBuffer is nuU a NullPointerException is thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative, 
an ArraylndexOutOfBoundsException is thrown. 

• CRRP3: if dstLength is greater than the length of the simple TLV List, an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException. OUT_OF_TLV_BOUND ARIES. 

6.2.5.5. 1 .3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shidl be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

6.2.5.5.2 Test Suite files 

Specific triggering: Unrecognized Envelope. 



Test Script: 


APL 


_2_ 


_ERH 


_COPY_BSS_ 


_l.scr 


Test Applet: 


AP1_ 


_2_ 


_ERH_ 


_COPY_BSS_ 


_l.java 


Load Script: 


API. 


.2. 


.ERH. 


.COPY_BSS. 


.l.ldr 


Cleanup Script: 


API. 


.2_ERH_COPY_BSS. 


.l.clr 


Parameter File: 


API. 


.2. 


.ERH. 


.COPY_BSS. 


.l.par 
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6.2.5.5.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


appendTLV with value length of 7 
NULL as Darameter to dslBuffer 


NiillPnintprFyppntinn i<? thrown 

1 Y LI 1 1 1 w III Lw 1 Awwl^ LI wl 1 lO LI 1 1 w VV 1 1 




2 










dstOffset ^ dstBuffer.length 

dstBuff er . length = 5 
dstOffset = 5 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength > dstBuffer.length 

dstBuffer.length = 5 

dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength > dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

dstBuffer.length = 5 

dstOffset = 

jHt-H-l-Tj^inj^-f-V\ — "1 

i_iO 1— J-i til iy U 11 — -L 


Array 1 ndexOutOfBoundsExceptio 
n is thrown 




7 


dstLength > length of the simple TLV list 

dstBuffer.length = 10 
dstOffset = 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




« 

o 


^iippp^^f III refill H^tRiiffpr thp whnip hiiffpr 

dstBuffer.length = 9 
dstOffset = 
dstLength = 9 






Q 


r^nmnarp thp hiiffpr 


riCOLJIL \Ji dl 1 Ciy OUI 1 l|JCll C7^y lo \J 




1 n 

1 u 


Ciipppeefiil poll HQtRiiffpr IQ nsirt nf hiiffpr 

dstBuffer.length = 15 
dstOffset = 3 
dstLength = 9 


Roci lit nf f*rirwi(\ ic 1 ^ 




1 1 


Compare the whole buffer 


RGSult of arrayCornpar6() is 




12 


Successful call, dstBuffer is part of a buffer 

dstBuffer.length = 15 
dstOffset = 3 
dstLength = 6 


Result of copyO is 9 




13 


Compare the whole buffer 


Result of arrayCompareO is 




14 


Successful call, copy with length =0 

dstBuffer.length = 15 
dstOffset = 15 
dstLength = 


Result of copyO is 15 





6.2.5.5.4 Test Coverage 



CRR number 


Test case number 


N1 


9, 11, 13 


N2 


8, 10, 12, 14 


PI 


1 


P2 


2, 3, 4, 5, 6 


P3 


7 


01 


Does not apply for Envelope response handler 



6.2.5.6 Method findTLV 

Test Area Reference: API_2_ERH_FINDBB. 
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6.2.5.6.1 Conformance requirement 

The method with following header shaU be compliant to its definition in the API. 

public byte findTLV(byte tag, byte occurrence) 
throws ToolkitException 

6.2.5.6. 1 . 1 Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of the TLV Ust (handler buffer): 

• CRRNl : the method is successful if the required occurrence exists then the corresponding TLV becomes current. 

• CRRN2: if the method is successful then it returns TLV_FOUND_CR_SET when Comprehension Required flag 
is set. 

• CRRN3 : if the method is successful then it returns TLV_FOUND_CR_NOT_SET when Comprehension 
Required flag is not set. 

• CRRN4: if the required occurrence of the TLV element does not exist, the current TLV is no longer defined and 
TLV_NOT_FOUND is returned. 

• CRRN5: The search method is comprehension required flag independent. 

6.2.5.6.1.2 Parameter errors 

• CRRPl: if an input parameter is not vahd (e.g. occurrence = 0) an instance of ToolkitException shall be thrown. 
The reason code shall be ToolkitException BAD_INPUT_PARAMETER. 

6.2.5.6.1.3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

6.2.5.6.2 Test Suite files 



Specific triggering: Unrecognized Envelope. 



Test Script: 


API. 


.2. 


ERH. 


.FINDBB. 


.l.scr 


Test Applet: 


API. 


.2. 


_ERH. 


_FTNDBB_ 


_l.java 


Load Script: 


API. 


.2. 


_ERH. 


_FINDBB_ 


_l.ldr 


Cleanup Script: 


API. 


.2. 


ERH. 


.FINDBB. 


.l.ch 


Parameter File: 


API. 


.2. 


ERH. 


.FINDBB. 


.l.par 



6.2.5.6.3 Test procedure 



id 


Description 


API Expectation 


APDU Expectation 


1 


append tlie handier with TLVs: 

81 03 11 22 33 

82 02 99 77 








invalid input parameter 

Occurrence = 


ToolkitException. BAD_INPUT_PA 
RAMETER is thrown 




2 










Search 1st TLV 


Result is TLV_FOUND_CR_SET 






Tag = Olh 








Occurrence = 1 






3 


Cail the getVaiueLengthQ method 


Result is 03h 




4 


Search 2nd TLV 

Tag = 02h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




5 


Cail the getVaiueLengthQ method 


Result is 02h 
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Id 


Description 


API Expectation 


APDU Expectation 


6 


Select a TLV (tag 02h) 








Search a wrong tag 


Result is TLV_NOT_FOUND 






Tag = 03h 








Occurrence = 1 






7 


Call the getValueLengthQ method 


ToolkitException . UNAVAILABLE 
ELEMENT is thrown. 




8 


Search a tag with wrong occurrence 

Tag = Olh 

Occurrence = 2 


Result is TLV_NOT_FOUND 




9 


Call the getValueLengthO method 


ToolkitException. UNAVAILABLE_ 
ELEMENT is thrown. 




10 


Append a TLV with tag=02h 








Search the TLV 


F^6sult is 






Tag = 02h 
Occurrence = 2 


TLV_FOUND_CR_NOT_SET 




11 


Append a TLV with tag=04h 








Search the TLV 


Result is 






Tag = 04h 


TLV FOUND CR NOT SET 






Occurrence = 1 






12 


Search tag 81 h 

Tag = 81h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




13 


Search tag 84h 

Tag = 84h 
Occurrence = 1 


F^6SLilt is 

TLV_FOUND_CR_NOT_SET 





6.2.5.6.4 Test Coverage 



CRR number 


Test case number 


N1 


3, 5 


N2 


2, 4 


N3 


10, 11 


N4 


6, 7,8, 9 


N5 


12, 13 


PI 


1 


01 


Does not apply for Envelope response handler 



6.2.5.7 Method getValueLength 

Test Area Reference: API_2_ERH_GVLE. 
6.2.5.7.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getValueLengthO 

throws ToolkitException 

6.2.5.7. 1 . 1 Normal execution 

• CRRNl : gets and returns the binary length of the value field for the last TLV element which has been foimd in 
the handler. 

6.2.5.7.1 .2 Parameter errors 

No requirements. 

6.2.5.7. 1 .3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 
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• CRRC2: in case of unavailable TLV element an instance of TooUdtException shall be thrown. The reason code 
shall be TooUdtException UNAVAILABLE_ELEMENT. 

6.2.5.7.2 Test Suite files 



Specific triggering: Unrecognized Envelope. 



Test Script: 


API_ 


_2_ 


_ERH 


_GVLE_ 


_l.scr 


Test Applet: 


API_ 


_2_ 


_ERH_ 


_GVLE_ 


_l.java 


Load Script: 


API_ 


_2_ 


_ERH_ 


_GVLE_ 


_l.ldr 


Cleanup Script: 


API. 


.2. 


ERH. 


.GVLE. 


.l.clr 


Parameter File: 


API. 


.2. 


ERH. 


.GVLE. 


.l.par 



6.2.5.7.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


■i 


appenu i lv 
findTLV with TAG 03 








getValueLengthO 


ToolkitException . UNAVAI LABLE 
ELEMENT is thrown 




2 


appendTLV with TAG OD and length 00 








Search TLV ODh 








getValueLength ( ) 


Result is OOh 




3 


Clear the handler and append TLV with TAG 
OD and length 02 








Search TLV ODh 








getValueLength ( ) 


Result is 02h 




4 


Clear the handler and append TLV with TAG 
OD and length 0x7F 








Search TLV ODh 








getValueLengthO 


Result is 7Fh 




5 


Clear the handler and append TLV with TAG 
OD and length 0x80 








Search TLV ODh 








getValueLength { ) 


Result is 80h 




6 


Clear the handler and append TLV with TAG 
OD and length OxFI 








Search TLV ODh 








getValueLength ( ) 


Result is F1 h 





6.2.5.7.4 Test Coverage 



CRR number 


Test case number 


N1 


2, 3, 4, 5, 6 


C1 


Does not apply for EnvelopeResponseHandler 


C2 


1 



6.2.5.8 Method getValueByte 

Test Area Reference: API_2_ERH_GVB YS. 
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6.2.5.8.1 Conformance requirement 

The method with following header shaU be compliant to its definition in the API. 

public byte getValueByte (short valueOffset) 
throws ToolkitException 

6.2.5.8. 1 . 1 Normal execution 

• CRRNl : Gets a byte from the last TLV element which has been found in the handler and returns its value 
(1 byte). 

6.2.5.8. 1 .2 Parameter errors 

• CRRP 1 : if valueOffset is out of the current TLV an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

6.2.5.8.1.3 Context errors 

• CRRCl: if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code 
shall be ToolkitException UNAVAILABLE_ELEMENT. 

6.2.5.8.2 Test Suite files 



Specific triggering: Unrecognized Envelope. 



Test Script: 


API. 


.2. 


ERH. 


.GYBYS. 


.l.scr 


Test Applet: 


API. 


.2. 


ERH. 


.GVBYS. 


.l.java 


Load Script: 


API. 


.2. 


ERH. 


.GYBYS. 


.l.ldr 


Cleanup Script: 


API. 


_2_ 


_ERH 


_GYBYS_ 


_l.ck 


Parameter File: 


API. 


X 


ERH 


.GVBYS. 


.l.par 



6.2.5.8.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


appendTLV 82 02 81 82, appendTLV 81 03 11 
22 FE 
flndlLV with TAG 03 








getValueByte (0) 


ToolkitException . UNAVAI LABLE_ 
ELEMENT is thrown 




2 


Search TLV 01 h 








getValueByte (3) 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




3 


Search TLV 01 h 








getValueByte (2) 


Result is FEh 




4 


Search TLV 02h 








getValueByte (0) 


Result is 81 h 




5 


appendTLV with TAG OD, Length 0x7E, Value: 
00, 01,..., 7D 








getValueByte (7D) 


Result is 7Dh 




6 


clear the handler, appendTLV with TAG OD, 
Length 0x80, Value: 00, 01, 7F 








getValueByte (7E) 


Result is 7Eh 




7 


getValueByte (7F) 


Result is 7Fh 





ETS/ 



3GPP TS 11.13 version 8.2.1 Release 1999 



103 



ETSI TS 101 955 V8.2.1 (2003-04) 



Id 


Description 


API Expectation 


APDU Expectation 


8 


clear the handler, appendTLV with TAG OD, 
Length OxFI, Value: 00, 01, FO 








getValueByte (FO) 


Result is FOh 





6.2.5.8.4 Test Coverage 



CRR number 


Test case number 


N1 


3, 4, 5, 6, 7, 8 


PI 


2 


C1 


Does not apply for EnvelopeResponseHandler 


C2 


1 



6.2.5.9 Method copyValue 

Test Area Reference: API_2_ERH_CPYVS_BSS. 

6.2.5.9.1 Conformance requirement 

The method with following header shall be compliant with its definition in the API. 

public short copyValue ( short valueOffset, 

byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws java . lang .NullPointerException, 

java . lang .Array IndexOutOfBoundsExcept ion. 
Toolkit Except ion 

6.2.5.9.1.1 Normal execution 

• CRRNl : copies a part of the last TLV element which has been foimd, into a destination, buffer. 

• CRRN2: returns dstOffset + dstLength. 

6.2.5.9.1.2 Parameter errors 

• CRRPl : if dstBuffer is nuU NullPointerException is thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException is thrown. 

• CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

6.2.5.9. 1 .3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code 
shall be ToolkitException UNAVAILABLE_ELEMENT. 

6.2.5.9.2 Test Suite files 



Specific triggering: Unrecognized Envelope. 



Test Script: 


API. 


.2. 


ERH. 


.CPYVS. 


.BSS. 


.l.scr 


Test Applet: 


APL 


_2_ 


_ERH 


_CPYVS_ 


_BSS_ 


_l.java 


Load Script: 


API. 


.2. 


ERH. 


.CPYVS. 


.BSS. 


.l.ldr 
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Cleanup Script: API_2_ERH_CPYVS_BSS_l.clr 
Parameter File: API_2_ERH_CPYVS_BSS_1 .par 



6.2.5.9.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


appendTLV with TAG: OD and length 16 
Select Text String TLV 








copyValueO with a null dstBuffer 


NullPointerException is thrown 




2 










dstOffset > dstBuffer.length 

dstBuff er . length = 5 
dstOffset = 5 
dstLength = 1 


ArraylndexOutOfBoundsException 
is ttirown 




3 


dstOffset < 

dstBuffer.length = 5 
QSTiuirseTi — 1 
dstLength = 1 


ArraylndexOutOfBoundsException 
is tlirown 




4 


dstLength >dstBuffer.length 

dstBuffer.length = 5 

dstOffset = 
dstLength = 6 


Array 1 ndexOutOfBoundsException 
is thrown 




5 


dstOffset + dstLength >dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


Array 1 ndexOutOfBoundsException 
is thrown 




6 


dstLength < 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


Array 1 ndexOutOfBoundsException 
is thrown 




7 


clear the handler, appendTLV with TAG: OD 
and length 6 
Select Text String TLV 








valueOffset > Text String Length 

valueOffset = 6 
dstBuffer.length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT_OF_TLV_B 
OUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
dstBuffer.length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT_OF_TLV_B 
OUNDARIES is thrown 




9 


dstLength > Text String length 

valueOffset = 
dstBuffer.length = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT OF TLV B 
OUNDARIES is thrown 




10 


valueOffset + dstLength > Text String length 

valueOffset = 2 
dstBuffer.length = 15 

dstOffset = 
dstLength = 5 


ToolkitException.OUT_OF_TLV_B 
OUNDARIES is thrown 




1 1 


Initialize the handler 








copyValue ( ) 


ToolkitException . UNAVAI LABLE 
ELEIVIENT is thrown 




12 


clear the handler, appendTLV with TAG: OD 
and value: 04 00 01 ... OF 
Select Text String TLV 








Successful call 

valueOffset = 
dstBuffer.length = 17 
dstOffset = 
dstLength = 17 


Result of copyValueO is 17 




13 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


14 


initialize dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

valueOffset = 2 


Result of copyValueO is 15 






dstBuffer . length = 20 








asturrset — 6 








dstLength = 12 






15 


Compare buffer 

buffer = 

cc cc cc fil 09 
00 00 00 U -1- UZ 

03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 


Result Is OOh 




16 


Successful call, copyValue with length =0 

dstBuffer. length = 20 
dstOffset = 20 
dstLength = 


Result of copyValueO is 20 





6.2.5.9.4 Test Coverage 



CRR number 


Test case number 


N1 


13, 15 


N2 


12, 14, 16 


PI 


1 


P2 


2, 3, 4, 5, 6 


P3 


7, 8, 9, 10 


CI 


Does not apply for EnvelopeResponseHandler 


C2 


11 



6.2.5.10 Method compareValue 

Test Area Reference: API_2_ERH_CPRVS_BSS. 
6.2.5.10.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte compareValue (short valueOffset, 

byte [ ] compareBuf fer, 
short compareOf f set, 
short compareLength) 
throws java . lang .NullPointerException, 

java . lang .Array IndexOutOfBoundsExcept ion, 
ToolkitException 

6.2.5.10.1.1 Normal execution 

Compares the last found TLV element with a buffer: 

• CRRNl : returns if identical. 

• CRRN2: returns -1 if the first miscomparing byte in simple TLV List is less than that in compareBuffer. 

• CRRN3: returns 1 if the first miscomparing byte in simple TLV List is greater than that in compareBuffer. 

6.2.5.10.1 .2 Parameter errors 

• CRRPl: if compareBuffer is nuU NullPointerException shall be thrown. 

• CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if 
compareLength is negative ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 
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6.2.5.10.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code 
shall be ToolkitException UNAVAILABLE_ELEMENT. 

6.2.5.10.2 Test Suite files 

Specific triggering: Unrecognized Envelope. 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.5.10.3 



API_2_ERH_CPRVS_BSS_1 .scr 
API_2_ERH_CPRVS_BSS_1 .Java 
API_2_ERH_CPRVS_BSS_1 .Idr 
API_2_ERH_CPRVS_BSS_1 .clr 
API_2_ERH_CPRVS_BSS_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


appendTLV with TAG: OD and length 16 
Select Text String TLV 








comnareValuen with a null comnareRuffer 

W^/ III I^CAI ^7 V Cll Wi^^l f Vv 1 H 1 CI ■ 1 U 1 1 w^/l 1 il^vll ^7 U 1 I wl 


Ni illPnintprFYrpntinn i*? thrnwn 

1 ^ U II 1 UN 1 1^1 L—AL/CkyllUI 1 lO LIIIUVVII 




2 










compareOffset > compareBuffer.length 

compareBuff er . length = 5 
compareOffset = 5 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

compareBuffer.length = 5 
compareOffset = -1 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareLength >compareBuffer.length 

compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + compareLength 
>compareBuffer.length 

compareBuffer.length = 5 
compareOffset = 3 
compareLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


compareLength < 

compareBuffer.length = 5 
compareOffset = 
compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


appendTLV with TAG: OD and length 6 
Select Text String TLV 








valueOffset ^ Text String Length 

valueOffset = 6 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


ToolkltException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
compareBuffer.length = 15 

compareOffset = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


compareLength > Text String length 

valueOffset = 
compareBuffer.length = 15 
compareOffset = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


10 


valueOffset + compareLengtli > Text String 
iength 

valueOffset = 2 
compareBuf fer . length = 15 
compareOf f set = 
compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


initialize the handler 








compareValue ( ) 


ToolkitException . UNAVAI LABLE 
ELEMENT is tlirown 




12 


appendTLV with TAG: OD and value: 04 00 01 
... OF 

Select Text String TLV 








Initialize compareBuffer 

compareBuffer = 
04 00 01 ... OF 









Compare buffers 

valueOffset = 


Result is OOli 






c O'lnp c-,. r e u r r s e t !j 








conipo.rej_iengtri 1 7 






13 


Initialize compareBuffer 

compareBuffer = 
04 00 01 02 03 

04 05 06 07 08 

05 OA OB OC OD 
OE 10 








Compare buffers with same parameters 


Result is -1 




14 


Initialize compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 




-I ^ 

1 


Initioli^A ommnoi'ADi iff Ai* 
ini1lall26 COinpar6DUTI6r 

cornpaireBuffe IT = 
cc cc cc ni no 

00 00 00 Ul uz 

03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 






- - 


Compare buffers 


Result is OOh 






valueOffset = 2 








CompareOf f set = 3 








compareLength = 12 






16 


Initialize compareBuffer 

compareBuffer = 
55 55 55 02 01 

03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers with same parameters 


Result is -1 




17 


Initialize compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OA OD 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 




18 


Successful call, compareValue with length =0 

compareBuf fer . length = 15 
compareOf f set = 15 
compareLength = 


Result of compareValueO is 
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CRR nuinber 

1111 II U III l^^^l 


Test casp number 

I I WUWW llUlllln/d 


N1 


12, 15, 18 


N2 


13, 16 


N3 


14, 17 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7, 8, 9, 10 


C1 


Does not apply for EnvelopeResponseHandler 


C2 


11 



6.2.5.1 1 Method findAndCopyValue(byte tag, byte[] dstBuffer, short valueOffset) 

Test Area Reference: API_2_ERH_FACYB_BS. 
6.2.5.1 1.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short f indAndCopyValue (byte tag, 

byte[] dstBuffer, 
short dstOffset) 
throws java . lang .NullPointerException, 

java . lang .Array IndexOutOfBoundsExcept ion, 
ToolkitException 

6.2.5.1 1.1.1 Normal execution 

• CRRN 1 : looks for the first occurrence of a TLV element from the beginning of a TLV list and copy its value into 
a destination buffer. 

• CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 

TLV is no longer defined. 



CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + length of the 
copied value is returned. 



• CRRN4: The search method is comprehension required fiag independent. 

6.2.5.11.1.2 Parameter errors 

• CRRPl : if dstBuffer is nuU NullPointerException shall be thrown. 

• CRRP2: if dstOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall be 
thrown. 

6.2.5.1 1 .1 .3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

6.2.5.11.2 Test Suite files 

Specific triggering: Unrecognized Envelope. 

Test Script: API_2_ERH_FACYB_BS_Lscr 

Test Applet: API_2_ERH_FACYB_BS_1 .java 

Load Script: API_2_ERH_FACYB_BS_Lldr 

Cleanup Script: API_2_ERH_FACYB_BS_Lch- 
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Parameter File: API_2_ERH_FACYB_BS_1 .par 



6.2.5.1 1 .3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialize the handler 








findAndCopyValueQ with a null dstBuffer 


NullPointerException is thrown 




2 


appendTLV with TAG: OD and length 16 
Select Text String TLV 








dstOffset ^ dstBuffer.length 

tag = ODh 

dstBuffer.length = 20 
dstOffset = 20 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 20 
dstOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstOffset + length >dstBuffer.length 

dstBuffer.length = 20 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


length > dstBuffer.length 

dstBuffer.length = 15 
dstOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


clear the handler, appendTLV with TAG 02 and 
Length 02 








oeieci a i lv ^lag u^n^ 








f indAndCopyValue ( ) 

tag = 03h 


ToolkitException . UNAVAI LABLE_ 

ELEIVIENT is thrown 






Call the getValueLengthO method 


Tooll<itException . UNAVAI LABLE_ 
ELEMENT is thrown. 




7 


appendTLV with TAG: OD and value: 04 00 01 
...OF 








Successful call 

Tag = ODh 

dstBuffer.length = 17 
dstOffset = 


Result of findAndCopyValueO is 
17 




8 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




9 


initialize dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

dstBuffer.length = 20 
dstOffset = 2 


Result of findAndCopyValueO is 
19 




10 


Compare buffer 

buffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 


Result is OOh 




11 


clear the handler, appendTLV with TAG: OD 
and value: 04 00 01 ... OF 








append a 2"'' Text String TLV 








Successful call 

tag = ODh 

dstBuffer.length = 17 
dstOffset = 


Result of findAndCopyValueO is 
17 




12 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




13 


clear the handler, appendTLV with TAG: OD 
and value: 04 00 01 ... OF 








Successful call (with tag BDh) 

tag = BDh 

dstBuffer.length = 17 
dstOffset = 


Result of findAndCopyValueO is 
17 
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Id 


Description 


API Expectation 


APDU Expectation 


14 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




15 


Append tag OFh 

buffer = 00 01 ... OF 








Successful call (with tag BFh) 

tag = 8Fh 

dstBuff er . length = 16 
dstOffset = 


Result of findAndCopyValueO Is 
16 




16 


Compare buffer 

buffer 00 01 ... Or 


Result is OOh 





6.2.5.11.4 Test Coverage 



CRR number 


Test case number 


N1 


8, 10, 12 


N2 


6 


N3 


7, 9, 11 


N4 


13, 14, 15, 16 


PI 


1 


P2 


2, 3, 4, 5 


CI 


Does not apply for EnvelopeResponseHandler 



6.2.5.12 Method findAndCopyValue(byte tag, byte occurrence, short valueOffset, 
byte[] dstBuffer, short dstOffset, short dstLength) 

Test Area Reference: API_2_ERH_FACYBBS_BSS. 
6.2.5.12.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short f indAndCopyValue (byte tag, 

byte occurrence, 
short valueOffset, 
byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsException, 
ToolkitException 

6.2.5.12.1.1 Normal execution 

• CRRNl : looks for the indicated occurrence of a TLV element from the begirming of a TLV Ust and copy its 
value into a destination buffer. 

• CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + dstLength is 
returned. 

• CRRN4: The search method is comprehension required flag independent. 

6.2.5.12.1 .2 Parameter errors 

• CRRPl : if dstBuffer is null NullPointerException shall be thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException shall be thrown. 
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• CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUNDARIES. 



6.2.5.12.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

6.2.5.12.2 Test Suite files 

Specific triggering: Unrecognized Envelope. 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.5.12.3 



API_2_ERH_FACYBBS_BSS_1 .scr 
API_2_ERH_FACYBBS_BSS_1 .java 
API_2_ERH_FACYBBS_BSS_1 .Idr 
API_2_ERH_FACYBBS_BSS_1 .clr 
API_2_ERH_FACYBBS_BSS_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


initialize the handier 








findAndCopyValuG() with a null dstBuffGr 


NullPointerException is thrown 




2 


appendTLV with TAG: OD and length 16 








dstOffset ^ dstBuffer.iength 

tag = ODh, occurrence = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 






valueOffset = 








dstBuffer.iength = 5 








dstOffset = 5 








dstLength = 1 






3 


dstOffset < 

dstBuffer.iength = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength >dstBuffer.iength 

dstBuffer.iength = 5 

dstOffset = 

dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength >dstBuffer.iength 

dstBuffer.iength = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

dstBuffer.iength = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


appendTLV with TAG: OD and length 6 








valueOffset ^ Text String Length 

tag = ODh, occurrence = 1 
valueOffset = 6 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 






dstBuffer.iength = 15 
dstOffset = 








dstLength = 1 






8 


valueOffset < 

valueOffset = -1 
dstBuffer.iength = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


dstLength > Text String length 

valueOffset = 
dstBuffer.iength = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


10 


valueOffset + dstLength > Text String length 

valueOffset = 2 
dstBuff er . length = 15 
dstOffset = 
dstLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


clear the handler, appendTLV with TAG 02 and 
Length 02 








Select a TLV (tag 02h) 








f indAndCopyValue ( ) 


ToolkitException.UNAVAILABLE_ 






tag = ODh 
occurrence = 2 


ELEMENT is thrown 






Call the getValueLength ( ) method 


Tooll<itException.UNAVAILABLE_ 
ELEIVIENT is thrown. 




1 2 


f^lpflr thA hflnHlpi* ftnfi #)nnpnHTLV with TAt^' 
OD and value: 04 00 01 ... OF 








ouccessTui call 


Result of findAndCopyValue() is 






tag = ODh, occurrence = 1 


17 






valueOffset = 








dstBuffer. length = 17 








dstOffset = 








dstLength = 17 






13 


Comoare buffer 

hm-F-Fnr = 04 DD 01 DF 
j-j u J- J- J- — uu u -l ... ur 


Rocijlt ic OOh 






inillallZ6 USTDUTier 

dstBuffer = 55 55 ... 55 








Successful call 


Result of findAndCopyValueO is 






tag = ODh, occurrence = 1 


15 






valueOffset = 2 








dstBuffer . length = 20 








dstOffset = 3 








dstLength = 12 






15 


Compare buffer 

buffer = 

DD DD DD Ui UZ 

03 04 05 06 07 
08 09 OA OR or 

crc cc cc cc cc 

~j ~j -J -J -J -J -J -J -J -J 


Result is OOh 




1 D 


Appeno a i exi oiring i lv 

tag = OD 

Durrer — UU ll Jo 44 oo (no speciric 
DCS byte) 






.. . . 


OUCCeSSTUI Call 


riesuii OT TinuAnaL'Opy V aiuey is 






tag = ODh, occurrence = 1 


17 






valueOffset = 








dstBuffer . length = 20 








dstOffset = 








dstLength = 17 






1 / 


^nmn9t*A l^i iff 

LrUinpare uuTTer 

buffer = 04 00 01 ... OF 


riesuii IS uun 




1 ft 
1 


OUi#l#co9lUI l#dll 

tag = ODh, occurrence = 2 
valueOffset = 
dstBuffer . length = 6 
dstOffset = 
dstLength = 6 


ricbUIL UI llllUMllUOUpy ValUc^^ lb O 




19 


Compare buffer 

buffer 00 11 22 jj 44 55 


Result is OOh 






r^lpftf thp hfrnrUpi* finri nnnpnriTI V with TAf^* 
UU aMU ValUc. UH- UU U 1 ■■■ Un 






■ 


Successful call (with tag SDh) 

Ldy — O L>ll 


Result of findAndCopyValue () is 

\ 1 






occurrence = 1 








valueOffset = 








dstBuff er . length = 17 








dstOffset = 








dstLength = 17 






21 


Compare buffer 

buffer = 04 00 01 ... OF 


Result Is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


22 


Append tag OFh 

Duiier = UU Ul ... UF 








Successful call (with tag SFh) 

tag = 8Fh 
occurrence = 1 
valueOffset = 
dstBuff er . length = 16 
dstOffset = 
dstLength = 16 


Result of findAndCopyVaiue () is 
16 




23 


Compare buffer 

buffer = 00 01 ... OF 


Result is OOh 




24 


Successful call, findAndCopyVaiue with length 
=0 

dstBuffer. length = 16 

dstOffset = 16 
dstLength = 


Result of findAndCopyVaiue () is 
16 





6.2.5.12.4 Test Coverage 



GRR number 


Test case number 


N1 


13, 15, 17, 19 


N2 


11 


N3 


12, 14, 16, 18, 24 


N4 


20, 21 , 22, 23 


PI 


1 


P2 


2, 3, 4, 5, 6 


P3 


7, 8, 9, 10 


CI 


Does not apply for EnvelopeResponseHandler 



6.2.5.13 Method findAndCompareValue(byte tag, byte[] compareBuffer, short 
compareOffset) 

Test Area Reference: API_2_ERH_FACRB_BS. 
6.2.5.13.1 Conformance requirement 

The method with following header shall be compliant to its definition in the APT 

public byte f indAndCompareValue (byte tag, 

byte [ ] compareBuffer, 
short compareOffset) 
throws java . lang .NullPointerException, 

java . lang .Array IndexOutOfBoundsExcept ion, 
ToolkitException 

6.2.5.13.1.1 Normal execution 

Looks for the first occurrence of a TLV element from beginning of a TLV list and compare its value with a buffer: 

• CRRNl: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN2: if the method is successful then the corresponding TLV becomes current. 

• CRRN3: if identical returns 0. 

• CRRN4: if the first miscomparing byte in simple TLV is less than that in compareBuffer returns -1. 

• CRRN5: if the first miscomparing byte in simple TLV is greater than that in compareBuffer returns L 

• CRRN6: The search method is comprehension required flag independent. 
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6.2.5.13.1 .2 Parameter errors 

• CRRPl: if compareBuffer is null NulIPointerException shaU be thrown. 

• CRRP2: if compareOffset would cause access outside array boimds ArraylndexOutOfBoundsException shall be 
thrown. 

6.2.5.13.1 .3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitExceptionHANDLER_NOT_AVAILABLE. 

6.2.5.13.2 Test Suite files 



Specific triggering: Unrecognized Envelope. 



Test Script: 


API. 


.2. 


ERH. 


.FACRB. 


.BS. 


.l.scr 


Test Applet: 


API. 


.2. 


ERH. 


.FACRB. 


.BS. 


.l.java 


Load Script: 


API. 


.2. 


ERH. 


.FACRB. 


.BS. 


.l.ldr 


Cleanup Script: 


API. 


.2. 


_ERH 


_FACRB_ 


_BS_ 


_l.ck 


Parameter File: 


API. 


.2. 


_ERH 


_FACRB_ 


_BS_ 


.l.par 



6.2.5.13.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


appendTLV with TAG: OD and lengtli 16 








findAndCompareValueO with a null dstBuffer and 
tag ODh 


NulIPointerException is thrown 




2_ 








compareOffset > compareBuffer.length 

tag = ODh 

compareBuffer.length = 20 
compareOffset =20 


ArraylndexOutOfBoundsExceptIo 
n is thrown 




3 


compareOffset < 

compareBuffer.length = 20 
compareOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareOffset + length > 
compareBuffer.length 

compareBuffer.length ^ 20 
compareOffset = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


length > compareBuffer.length 

compareBuffer.length = 15 
compareOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


clear the handler, appendTLV with TAG 02 and 
Length 02 








Select a TLV (tag 02h) 








f indAndCompareValue () 
tag = 03h 


Tooll<itException.UNAVAILABLE_ 
ELEIVIENT is thrown 




7 


Verify current TLV 

getValueLength ( ) 


Tooll<itException.UNAVAILABLE_ 
ELEMENT is thrown. 




8 


clear the handler and appendTLV with TAG: 
OD and value: 04 00 01 ... OF 








Initialize compareBuffer 

compareBuffer = 
04 00 01 ... OF 








Compare buffers 

tag = ODh 
compareOffset = 


Result is OOh 




9 


Verify current TLV 

getValueLength ( ) 


Result is 17 
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Id 


Description 


API Expectation 


APDU Expectation 


10 


Initialize compareBuffer 

compareBuffer = 
04 00 01 ... 10 








Compare buffers with same parameters 


Result is -1 




11 


Initialize compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 




1 c. 


lllllldll^c OUIIIUdlCDU 1 Id 

compareBuffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 








Compare buffers 


Result is OOh 






c omp a r eO f f s e t — 2 






\ O 


appenu a lexioiriny ilv 

tag — uun 

buffer = 00 11 22 33 44 55 






___ 


lnifi£ili7A o/imnorARi iff Ai* 
lllllldll^c OUIIIUdlcDU 1 Id 

compareBuffer = 

55 55 04 00 01 








02 03 04 05 06 








07 08 09 OA OB 








OC OD OE OF 55 








r^mvinsifA 111 iff Are 
wUllipdic UUIIcld 

compareOf f set = 2 






14 


Initialize compareBuffer 

compareBuffer = 
55 55 04 01 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 








Compare buffers 

compareOffset = 2 


Result is -1 




\ 


InifialivA o/imnoi'ADiiffAi' 
lllllldll^c OUIIIUdlCDU 1 Id 

compareBuffer = 

55 55 04 00 01 

02 03 04 05 06 

07 08 09 OA OB 

OC OD OD 10 55 








Compare buffers 


Result is +1 






compareOffset = 2 






16 


clear the handler and appendTLV with TAG: 
OD and value: 04 00 01 ... OF 








Initialize compareBuffer 

compareBuffer = 04 00 01 ... OF 









Successful call (with tag SDh) 


Result is OOh 






tag = 8Dh 

compareBuf fer . length = 17 
compareOffset = 






17 


Append tag OFh 

buffer = 00 01 ... OF 








Initialize compareBuffer 

compareBuffer = 00 01 ... OF 








Successful call (with tag 8Fh) 

tag = 8Fh 


Result is OOh 






compareBuf fer . length = 16 








compareOffset = 
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C^RR niiinhpr 


Tp^t PfiQP niiiYihpr 

1 cot ^aoc iiuiiiud 


N1 


fi 7 


N2 


7,9 


N3 


8, 13, 12 


N4 


10, 14 


N5 


11,15 


N6 


17, 16 


P1 


1 


P2 


2, 3, 4, 5 


C1 


Does not apply for Envelope response handler 



6.2.5.14 Method findAndCompareValue(byte tag, byte occurrence, short valueOffset, 
byte[] compareBuffer, short compareOffset, short compareLength) 

Test Area Reference: API_2_ERH_FACRBBS_BSS. 
6.2.5.14.1 Conformance requirement 

The method with following header shall be compliant to its definition in the APT 

public byte f indAndCompareValue (byte tag, 

byte occurrence, 
short valueOffset, 
byte [ ] compareBuffer, 
short compareOffset, 
short compareLength) 
throws java . lang .NullPointerException, 

java . lang .Array IndexOutOfBoundsExcept ion, 
ToolkitException 

6.2.5.14.1.1 Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of a TLV Ust and compare its value with a 
buffer: 

• CRRN 1 : if no TLV element is found, the UN AV AILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN2: if the method is successful then the corresponding TLV becomes current. 

• CRRN3: if identical is returned. 

• CRRN4: if the first miscomparing byte in simple TLV is less than that in compareBuffer -1 is returned. 

• CRRN5: if the first miscomparing byte in simple TLV is greater than that in compareBuffer 1 is returned. 

• CRRN6: The search method is comprehension required flag independent. 

6.2.5.14.1 .2 Parameter errors 

• CRRPl: if compareBuffer is nuU NullPointerException shall be thrown. 

• CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if 
compareLength is negative ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: if valueOffset, compareLength or both are out of the current TLV an instance of ToolkitException shall 
be thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

• CRRP4: if an input parameter is not vahd (e.g. occurrence = 0) an instance of ToolkitException shall be thrown. 
The reason code shall be ToolkitException BAD_INPUT_PARAMETER. 
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6.2.5.14.1 .3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

6.2.5.14.2 Test Suite files 

Specific triggering: Unrecognized Envelope. 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.5.14.3 



API_2_ERH_FACRBBS_BSS_1 .scr 
API_2_ERH_FACRBBS_BSS_1 .Java 
API_2_ERH_FACRBBS_BSS_1 .Idr 
API_2_ERH_FACRBBS_BSS_1 .ch- 
API_2_ERH_FACRBBS_BSS_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


4 
1 


initialize the handler 








findAndCompareVaiueO with a null 
compareBuffer 


NullPointerException is thrown 




2 


clear the handler and appendTLV with TAG: 
CD and value: 04 00 01 ... OF 








compareOffset ^ compareBuffer.length 

tag = ODh, occurrence = 1 
valueOffset = 
compareBuffer.length = 5 
compareOffset = 5 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


compareOffset < 

compareBuffer.length = 5 
compareOffset = -1 

compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




4 


compareLength >compareBuffer.length 

compareBuffer.length = 5 

compareOffset = 

compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + compareLength 
>compareBuffer.length 

compareBuffer.length = 5 
compareOffset = 3 
compareLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


compareLength < 

compareBuffer.length = 5 
compareOffset = 
compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


clear the handler and appendTLV with TAG 
and length of 6 








valueOffset > Text String Length 

tag = ODh, occurrence = 1 
valueOffset = 6 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


ToolkitException. OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


compareLength > Text String length 

valueOffset = 
compareBuffer.length = 15 
compareOffset = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 





ETSI 



3GPP TS 11.13 version 8.2.1 Reiease 1999 



118 



ETSi TS 101 955 V8.2.1 (2003-04) 



Id 


Description 


API Expectation 


APDU Expectation 


10 


valueOffset + compareLengtli > Text String 
length 

valueOffset = 2 
compareBuf fer . length = 15 
compareOf f set = 
compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Invalid parameter 

occurrence = 


Tooll<itException.BAD_INPUT_PA 
RAMETER is thrown 




12 


appendTLV with TAG 02 and length 02 








Select a TLV (tag 02h) 








f IndAndCompareValue () 
tag = ODh 
occurrence = 2 


ToolkitException.UNAVAILABLE_ 
ELEMENT is thrown 




13 


Verify current TLV 

getValueLength ( ) 


ToolkitException . UNAVAI LABLE_ 
ELEIVIENT is thrown. 




14 


clear the handler and appendTLV with TAG: 
OD and value: 04 00 01 ... OF 






■- 


compareBuffer = 
04 00 01 ... OF 








findAndCompareValueO 

tag = ODh, occurrence = 1 


Result is OOh 






valueOffset = 








compareOf f set = 








compareLength = 17 






15 


Verify current TLV 

getValueLength ( ) 


Result is 17 




16 


initialize compareBuffer 

compareBuffer = 
04 00 01 ... 10 








Compare buffers with same parameters 


Result is -1 




17 


Initialize compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Compare buffers with same parameters 


Result is +1 




-1 Q 
1 O 


Initioli^A ^rnvmofARi iff Ai* 
inillall26 CUinpar6DUTT6r 

compareBuffer = 
cc cc cc ni no 

DO DO U-L uz 

03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers 

valueOffset = 2 


Result is OOh 






compareOf f set = 3 
compareLength = 12 






19 


initialize compareBuffer 

compareBuffer = 
55 55 55 02 01 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 






■- 


Compare buffers with same parameters 


Result is -1 




20 


Initialize compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OA OD 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 




21 


append a Text String TLV 

tag = ODh 

buffer = 00 11 22 33 44 55 








Initialize comnareBuffer 

compareBuffer = 








04 00 01 ... OF 








findAndCompareValueO 

tag = ODh, occurrence = 1 


Result is OOh 






valueOffset = 








compareOf f set = 








compareLength = 17 
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Id 


Description 


API Expectation 


APDU Expectation 


C.C. 


II iiiidii^t? 1 i^di CDU 1 ici 

compareBuf f er = 
00 11 22 33 44 55 








1 11 lUMI lUvrUllipcll c V dlUc^^ 

tag = ODh, occurrence = 2 


Dfsci lit ic nnki 
ricbUIL lo UUll 






valueOffset = 








compar eOf f set = 








compareLength = 6 








IIIIIICIII^C 1 lUCII CDU 1 1 CI 

compareBuf fer = 
00 11 22 33 44 66 








findAndCompareValueQ 

tag = ODh, occurrence = 2 


Result is -1 






valueOffset = 








compareOf f set = 
compareLength = 6 






24 


clear the handler and appendTLV with TAG: 
OD and value: 04 00 01 ... OF 








lnitifili7P pnmnm'pRiiff Ai" 

IIIIIICIII^C 1 IMCll C DU 1 1 CI 

compareBuf fer = 04 00 01 ... OF 








Qi ir^/^oeef 1 il osill /urith tan Af^h^ 
ouwwcdaiui ^dii ^wiiii idy ouiiy 


Roci lit ic nnh 






tag = 8Dh, occurrence = 1 








valueOffset = 








compareBuf fer . length = 17 
compareOf f set = 
compareLength = 17 






25 


Append tag OFh 

buffer = 00 01 ... OF 








Initi9li70 onmnfirARi iffor 
iiiiiidii^c wuii i|jdi t?Dij iici 








compareBuf fer = 00 01 ... OF 








Successful call (with tag SFh) 


Result is OOh 






tag = SFh, occurrence = 1 








valueOffset = 








compareBuf fer . length = 16 








compareOf f set = 








compareLength = 16 






26 


Successful call, findAndCompareValue with 
length =0 

CompareBuf fer . length = 16 
compareOf f set = 16 
compareLength = 


Resuit of findAndCompareValue 
is 00 





6.2.5.14.4 Test Coverage 



CRR number 


Test case number 


N1 


12,13 


N2 


15,13 


N3 


14, 18, 22, 21, 26 


N4 


16, 19, 23 


N5 


17, 19 


N6 


25, 24 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7, 8, 9, 10 


P4 


11 


C1 


Does not appiy for EnvelopeResponseHandler 



6.2.5.15 Method appendArray 

Test Area Reference: API_2_ERH_APDA_BSS. 
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6.2.5.15.1 Conformance requirement: 

The method with following header shaU be compliant to its definition in the API. 

void appendArray (byte [ ] buffer, short offset, short length) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOfBoundsExcept ion, 
ToolkitException 

6.2.5.15.1.1 Normal execution 

• CRRNl : appends a buffer into the EditHandler buffer. 

• CRRN2: a successful append does not modify the TLV selected. 

6.2.5.15.1.2 Parameters error 

• CRRP 1 : if buffer is null, a j ava.lang.NuUPointerException is thrown. 

• CRRP2: if offset or length or both would cause access outside the array bounds, or if length is negative, a 
java.lang.ArraylndexOutOfBoimdsException is thrown. 



6.2.5.15.1.3 



Context errors 



• CRRCl: if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER NOT AVAILABLE. 



6.2.5.15.2 Test suite files 

Specific triggering: Unrecognized Envelope. 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.5.15.3 



API_2_ERH_APDA_BSS_1 .scr 
API_2_ERH_APDA_BSS_1 .java 
API_2_ERH_APDA_BSS_1 .Idr 
API_2_ERH_APDA_BSS_1 .ch 
API_2_ERH_APDA_BSS_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 




Initialize the envelope response handler with a 
TLV of length 1 






1 


Null buffer 


NullPointerException is tlirown 




2 


offset ^ buffer, length 

buf fer . length = 5 
offset = 5 
length = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


offset < 

buf fer . length = 5 
offset = -1 
length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > buffer.length 

buf fer . length = 5 

offset = 
length = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


offset + length > buffer.length 

buffer.length = 5 
offset = 3 
length = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 





icngin < u 

buffer . length = 5 
offset = 
Isngth = —1 


Array inucxvjuTLJTDOuriastxcepiio 
n is thrown 




7 


Handler overflow 

buf fer . length = 256 
offset = 
length = 256 


ToolkitException. HANDLER OVE 
RFLOW is thrown 




8 


append the handler with TLVs: 

81 03 11 22 33 

82 02 99 77 








findTLV 0x81 








Successful call 








buffer = FF FE ... F8 








offset = 








length = 8 








Verify Current TLV: Call getVaiueLengthQ 


Result is 03h 




9 


Clear the handler 








Successful call 








buffer = FF FE ... F8 








offset = 








length = 8 








Call copyO method 








Compare handler 


Result is OOh 






compareBuf f er = FF FE ... F8 






10 


Successful call 

buffer = 00 01 ... 07 
offset = 2 
length = 6 








Call copvO method 








Compare handler 

compareBuf fer = FF FE ... F8 02 03 ... 07 


Result Is OOh 




11 


Successful call 

buffer = 11 22 ... 88 

offset = 2 
length = 4 








Call copvO method 








Compare handler 


Result is OOh 






compareBuffer = FF FE ... F8 02 03 ... 07 33 








44 55 66 







6.2.5.15.4 Test Coverage 



CRR number 


Test case number 


N1 


9, 10, 11 


N2 


8 


N3 




PI 


1 


P2 


2, 3, 4, 5, 6 


01 


7 


02 


Does not apply for EnvelopeResponseHandler 



6.2.5.16 Method appendTLV(byte tag, byte value) 

Test Area Reference: API_2_ERH_APTLBB. 
6.2.5.16.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

void appendTLV (byte tag, byte value) 
throws ToolkitException 
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6.2.5.16.1.1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV list (1-byte element). 

• CRRN2: A successful append does not modify the TLV selected. 

6.2.5.16.1.2 Parameters error 
No requirements. 

6.2.5.16.1.3 Context errors 

• CRRCl: if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 

6.2.5.16.2 Test suite files 



Specific triggering: Unrecognized Envelope. 



Test Script: 


API. 


.2. 


ERH. 


.APTLBB. 


.l.scr 


Test Applet: 


API. 


.2. 


ERH. 


.APTLBB. 


.l.java 


Load Script: 


API. 


.2. 


ERH. 


.APTLBB. 


.l.ldr 


Cleanup Script: 


API. 


.2. 


ERH. 


.APTLBB. 


.l.clr 


Parameter File: 


API. 


.2. 


ERH. 


.APTLBB. 


.l.par 



6.2.5.16.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call appendArrayO 

length = 253 








Handler Overflow: Call twice the 
appendTLVQinethod 


ToolkitException. HANDLER_OVE 
RFLOW is thrown by one of the 
two. 




2 


append the handler with TLVs: 

81 03 11 22 33 

82 02 99 77 








Select Command Details TLV 








Call the appendTLVO method 








Verify Current TLV: Call getVaiueLengthQ 


Result is 03h 




3 


Clear the handler 








Successful call 








tag = 84h 
value = OOh 








Call copyO method 








Compare handler 

compareBuf fer = 84 01 00 


Result is OOh 




4 


Successful call 

tag = Olh 
value = FEh 








Call copyO method 








Compare handler 

compareBuf fer = 84 01 00 01 01 FE 


Result is OOh 




NOTE: Test case 1 call twice appendlLV because the current GSM 03.1 9 [7] is not clear enough on this point. So this 




test allows the two possible implementations. 
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6.2.5.16.4 Test Coverage 



CRR number 


Test case number 


N1 


3,4 


N2 


2 


C1 


1 


C2 


Does not apply for EnvelopeResponseHandler 



6.2.5.1 7 Method appendTLV(byte tag, byte valuel , byte value2) 

Test Area Reference: API_2_ERH_APTLBBB. 
6.2.5.17.1 Conformance requirements: 

The method with following header shall be compliant to its definition in the API. 

void appendTLV (byte tag, byte valuel, byte value2) 
throws ToolkitException 

6.2.5.17.1.1 Normal execution 

• CRRNl : Appends a TLV element to the current TLV list (2-byte element). 

• CRRN2: A successful append does not modify the TLV selected. 

6.2.5.17.1.2 Parameters error 

No requirements. 

6.2.5.17.1 .3 Context errors 

• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAlLABLE. 



6.2.5.17.2 Test suite files 

Specific triggering: Unrecognized Envelope. 



Test Script: 


API. 


.2. 


ERH. 


.APTLBBB_ 


l.scr 


Test Applet: 


APT 


_2_ 


_ERH_ 


_APTL BBB 


_1 .Java 


Load Script: 


APL 


_2_ 


_ERH_ 


_APTL BBB 


_l.ldr 


Cleanup Script: 


APL 


_2_ 


_ERH_ 


_APTLBBB_ 


l.ch 


Parameter File: 


API. 


.2. 


ERH. 


.APTLBBB_ 


l.par 
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6.2.5.17.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call the appendArray with length of 253 








Handler Overflow: Call the appendTLV() 
method 


ToolkitException.HANDLER_OVE 
RFLOW is thrown 




2 


clear the handler, append the handler with 
TLVs: 

81 03 11 22 33 

82 02 99 77 








Select Command Details TLV 








Call the appendTLVO method 








Verify Current TLV: Call getValueLengthQ 


Result is 03h 




3 


Clear the handler 








Successful call 
















valuel = OOh 








value2 = Olh 









Call copyO method 








Compare handler 

compareBuf fer = 84 02 01 


Result Is OOh 




4 


Successful call 

tag = Olh 

valuel = FEh 
value2 = FDh 








Call copyO method 








Compare handler 

compareBuf fer = 84 02 00 01 01 02 FE FD 


Result Is OOh 





6.2.5.17.4 Test Coverage 



CRR number 


Test case number 


N1 


3,4 


N2 


2 


01 


1 


02 


Does not apply for EnvelopeResponseHandler 



6.2.5.18 Method appendTLV(byte tag, byte[ ] value, short valueoffset, short 
valuelength) 

Test Area Reference: API_2_ERH_APTLB_BSS. 
6.2.5.18.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

void appendTLV (byte tag, 

byte [ ] value, 
short valueoffset, 
short valuelength) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsException, 
ToolkitException 

6.2.5.18.1.1 Normal execution 

• CRRNl : Appends a TLV element to the current TLV Ust (byte-array element). 

• CRRN2: A successful append does not modify the TLV selected. 

6.2.5.18.1.2 Parameters error 

• CRRPl : if value is nuU, a java.lang.NulIPointerException is thrown. 



ETSI 



3GPP TS 11.13 version 8.2.1 Release 1999 



125 



ETSI TS 101 955 V8.2.1 (2003-04) 



• CRRP2: if valueoffset or valuelength or both would cause access outside the array bounds, or if length is 
negative, a java.lang.ArraylndexOutOfBoundsException is thrown. 



6.2.5.18.1.3 



Context errors 



• CRRCl : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 

• CRRC3: if valuelength is greater than 255, a ToolkitException is thrown with reason code 
BAD INPUT PARAMETER. 



6.2.5.18.2 Test suite files 

Specific triggering: Unrecognized Envelope. 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.5.18.3 



API_2_ERH_APTLB_BSS_l.scr 
API_2_ERH_APTLB_BSS_1 .Java 
APl_2_ERH_APTLB_BSS_l.ldr 
AP1_2_ERH_APTLB_BSS_1 .clr 
API_2_ERH_APTLB_BSS_l.par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Null value 


NullPointerException is thrown 




2 


valueOffset > value.length 

value. length = 5 
valueOffset = 5 
valueLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


valueOffset < 

value.length = 5 
valueOffset = -1 
valueLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


valueLength > value.length 

value.length = 5 
valueOffset = 
valueLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


ValueOffset + valueLength > value.length 

value.length ^ 5 
valueOffset = 3 
valueLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


valueLength < 

value.length = 5 

valueOffset = 
valueLength = -1 


Array 1 ndexOutOfBoundsExceptio 
n is thrown 




7 


Handler overflow 

value.length = 254 
valueOffset = 
valueLength = 254 


Tooll<itException.HANDLER_OVE 
RFLOW is thrown 




8 


Bad parameter 

value.length = 256 
valueOffset = 
valueLength = 256 


ToolkitException.BAD_INPUT_PA 
RAMETER is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


9 


clear the handler, append the handler with 
TLVs: 

81 03 11 22 33 

82 02 99 77 








Select Command Details TLV 








Successful call 








tag = 04 








value = FF FE ... F8 








valueOffset = 








valueLength = 8 








Verify Current TLV: Call getValueLengthQ 


Result is 03h 




10 


Clear the handler 








Successful call 








tag = 04 








value = FF FE ... F8 








valueOffset = 








valueLength = 8 








Call copyO method 









Compare handler 


Result is 00 






CompareBuf fer = 04 08 FF FE ... F8 






-| -| 


Successful call 

tag = 85h 
value = 00 01 ... 07 
valueOffset = 2 
valueLength = 6 








Call copvO method 








ooiTipare nariuicr 


rieSUIT IS UU 






compareBuf f er = 04 08 FF FE ... F8 85 06 02 








03 ... 07 






12 


Successful call 

tag = 01 

value = 11 22 ... 88 
valueOffset = 2 
valueLength = 4 








Call copvO method 








Comnarp handler 


Rpciiit iQ no 

1 ICOUIL iO \J\J 






compareBuf fer = 04 08 FF FE ... F8 85 06 02 








03 ... 07 01 04 33 44 55 66 






13 


Clear the handler 








Successful call 








tag = 04 








value = 00 01 ... 7F 








valueOffset = 








valueLength = 80h 








Call copyO method 








Compare handler 


Result is 00 






compareBuf fer = 04 81 80 00 01...7F 







6.2.5.18.4 Test Coverage 



CRR number 


Test case number 


N1 


10, 11, 12, 13 


N2 


9 


PI 


1 


P2 


2, 3, 4, 5, 6 


01 


7 


02 


Does not apply for EnvelopeResponseHandler 


03 


8 



6.2.5.19 Method appendTLV(byte tag, byte valuel , byte[ ] value2, short value2offset, 
short value2length) 

Test Area Reference: API_2_ERH_APTLBB_BSS. 
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6.2.5.19.1 Conformance requirement 

The method with following header shaU be compliant to its definition in the API. 

void appendTLV (byte tag, 

byte valuel 
byte [ 1 value2 , 
short value2of f set , 
short value21ength) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsException, 
ToolkitException 

6.2.5.19.1.1 Normal execution 

• CRRNl : Appends a TLV element to the current TLV Ust (1 byte and a byte-array element). 

• CRRN2: A successful append does not modify the TLV selected. 

6.2.5.19.1.2 Parameters error 

• CRRPl : if value2 is null, a java.lang.NuUPointerException is thrown. 

• CRRP2: if value2offset or value21ength or both would cause access outside the array bounds, or if length is 
negative, ajava.lang.ArraylndexOutOfBoundsExceptionis thrown. 



6.2.5.19.1.3 



Context errors 



• CRRCl: if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 

• CRRC3: if valuelength is greater than 255, a ToolkitException is thrown with reason code 
BAD INPUT PARAMETER. 



6.2.5.19.2 Test suite files 

Specific triggering: Unrecognized Envelope. 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.5.19.3 



API_2_ERH_APTLBB_BSS_1 .scr 
API_2_ERH_APTLBB_BSS_1 .java 
API_2_ERH_APTLBB_BSS_1 .Idr 
API_2_ERH_APTLBB_BSS_1 .clr 
API_2_ERH_APTLBB_BSS_1 .par 

Test procedure 



id 


Description 


API Expectation 


APDU Expectation 


1 


Null value2 


NullPointerException is thrown 




2 


value20ffset ^ value2.length 

value2 . length = 5 
value20ffset = 5 
value2Length = 1 


Array 1 ndexOutOfBoundsExceptio 
n is tiirown 




3 


value20ffset < 

value2 . length = 5 
value20ffset = -1 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


value2Length > value2.length 

value2 . length = 5 
value20ffset = 
value2Length = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 





Vaiuu^wTTSci + VaiUc^Lcnyin > Vaiuc^.icnyin 

value2 . length = 5 
value20ffset = 3 
value2Length = 3 


ArrayinucX'^UTL^TDOunastxcepiio 
n is thrown 




D 


vaiue^Lengin < u 

value2 . length = 5 
value20ffset = 
value2Length = -1 


Array IndexOutOfBoundsExcGptio 
n is thrown 




7 


naiiuicr Overflow 

value2 . length = 254 
value20ffset = 
value2Length = 254 


1 OOIKIItXCcpilOri.nMINIJLtn_V^VC 

RFLOW is thrown 




o 


value2 . length = 256 
value20ffset = 
value2Length = 256 


TnnlkitFyrpntinn RAD INPI IT PA 
RAMETER is tlirown 




9 


clear the handler, append the handler with 
TLVs: 

R1 03 11 99 33 
82 02 99 77 








Select Command Details TLV 








Successful call 








tag = 04 








valuel = 05 








value2 = FF FE ... F8 








value20ffset = 








value2Length = 8 








Verify Current TLV: Call getValueLength() 


Result is 03h 




10 


Clear the handler 








Successful call 








tag = 04 








valuel = 05 








value2 = FF FE ... F8 








value20ffset = 








value2Length = 8 









Call copyO method 








ooffipare nanuier 

CompareBuf f er = 04 09 05 FF FE ... F8 


DaoiiI+ \e> f\f\ 

rieSUIT IS UU 




1 1 


Successful call 

tag = 85h 

value2 = 00 01 ... 07 
value20ffset = 2 
value2Length = 6 








Call copvO method 








Compare handler 


Result is 00 






CompareBuf fer = 








Uy Uo rr r h. ... to 








85 07 55 02 03 ... 07 






12 


Successful call 

tag = 01 

-!7-;q 1 ne^l = 4 4h 

T7-;q lllfi? = 11 ?? SS 
VCl-LULCi:-^ — -L-L ... OO 

value20ffset = 2 
value2Length = 4 








Call copyQ method 








Comnare handler 

III I^Cll 1 ICII 1^4 Iwl 

(^i^TTlT^a T~ClRn "f" "f" Q T" = 
^ V^JltlLJCl i- O LL J- J- ^ i_ — 

04 DQ OR FF FF F8 


Rpcijit iQ no 

1 ICOUIL iO \J\J 






ftS 01 09 07 








01 05 44 33 44 55 66 






13 


Clear the handler 








Successful call 








tag = 04 








valuel = 00 








value2 = 01 ... 7F 








value20ffset = 








value2Length = 7Fh 








Call copyO method 








Compare handler 


Result is 00 






CompareBuf fer = 04 81 80 00 01...7F 
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CRR number 


Test case number 


N1 


10, 11, 12, 13 


N2 


9 


P1 


1 


P2 


2, 3, 4, 5, 6 


CI 


7 


C2 


Does not apply for EnvelopeResponseHandler 


C3 


8 



6.2.5.20 Method clear 

Test Area Reference: API_2_ERH_CLER. 
6.2.5.20.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

void clear () 

throws ToolkitException 

6.2.5.20. 1 . 1 Normal execution 

• CRRNl : Clears the TLV hst of an EditHandler and resets the current TLV selected. 



6.2.5.20.1.2 

No requirements. 

6.2.5.20.1.3 



Parameters error 



Context errors 



• CRRCl: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER NOT AVAILABLE. 



6.2.5.20.2 Test suite files 

Specific triggering: Unrecognized Envelope. 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.5.20.3 



API_2_ERH_CLER_1 .scr 
API_2_ERH_CLER_1 .Java 
API_2_ERH_CLER_1 .Idr 
API_2_ERH_CLER_1 .clr 
API_2_ERH_CLER_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


append the handler with TLVs: 

81 03 11 22 33 

82 02 99 77 

Select Command Details TLV 
Call the getLengthO method 


Result of getLengthO Is not null 






Clear the handler 

Call the getLengthO method 


Result of getLengthO is 




2 


Call the getValueLengthQ method 


ToolkitException . UNAVAI LABLE_ 
ELEMENT is thrown 





ETSI 



3GPP TS 11.13 version 8.2.1 Release 1999 



130 



ETSI TS 101 955 V8.2.1 (2003-04) 



6.2.5.20.4 



Test Coverage 



CRR number 


Test case number 


N1 


1,2 


C1 


Does not apply for EnvelopeResponseHandler 



6.2.6 Class MEProfile 

6.2.6.1 Method check (byte index) 

Test Area Reference: API_2_MEP_CHECB. 

6.2.6.1.1 Conformance requirement 

The method with following header shall compliant to its definition in the API. 

public static boolean check (byte index) 
throws ToolkitException 

6.2.6.1 .1 .1 Normal execution 

• CRRNl: The method checks a facility in the handset profile: returns true if supported and false otherwise. 

6.2.6.1.1.2 Parameters error 
No requirements. 

6.2.6.1.1.3 Context errors 

• CRRC 1 : The method shall throw ME_PROFILE_NOT_A VAIL ABLE ToolkitException if Terminal Profile data 
are not available 

6.2.6.1.2 Test suite files 
Specific triggering: 

EVENT_STATUS_COMMAND. 
No Additional requirements for the GSM personalization: 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.6.1.3 



AP1_2_MEP_CHECB_1 .scr 
AP1_2_MEP_CHECB_1 .Java 
AP1_2_MEP_CHECB_1 .Idr 
AP1_2_MEP_CHECB_1 .ck 
AP1_2_MEP_CHECB_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


No Terminal Profile is registered 

Triggered by status command 
Index = 1 


ME_PROFILE_NOT_AVAILABLE 
ToolkitException is thrown 




2 


Terminal Profile, Facility is supported 

index = 


true is returned by the method 




3 


Terminal Profile, Facility is not supported 

index = 15 


false is returned by the method 
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6.2.6.1.4 Test Coverage 



CRR number 


Test case number 


N1 


2,3 


C1 


1 



6.2.6.2 Method check (byte [ ] mask, short offset, short length) 

Test Area Reference: API_2_MEP_CHEC_BSS 

6.2.6.2.1 Conformance requirement: 

The method with following header shall compliant to its definition in the API. 

public static boolean check (byte [] mask, 

short offset, 
short length) 
throws java . lang . NullPointerExcept ion, 

java . lang . ArraylndexOutOf BoundsExcept ion. 
Toolkit Except ion 

6.2.6.2.1.1 Normal execution 

• CRRNl: The method checks all the facilities corresponding to bits set to 1 in the mask buffer: returns true if 
they are all supported and false if not. 

• CRRN2: The method returns true if the length to check is 0. 

6.2.6.2.1 .2 Parameters error 

• CRRPl: The method shall throw java. lang. NullPointerException if mask is null. 

• CRRP2: The method shall throw java. lang. ArraylndexOutOfBoundsException if offset or length or both would 
cause access outside array bounds. 

• CRRP3: The method shall throw ME_PROFILE_NOT_AVAILABLE ToolkitException if Terminal Profile data 
are not available. 

6.2.6.2.1.3 Context errors 

No requirements. 

6.2.6.2.2 Test suite files 
Specific triggering: 

UNFORMATTED_SMS_PP_UPD. 
No Additional requirements for the GSM personalization: 
Test Script: API_2_MEP_CHEC_BSS_l.scr 
Test Applet: API_2_MEP_CHEC_BSS_l.java 

Load Script: API_2_MEP_CHEC_BSS_1 .Idr (the applet is loaded without INI after the reset (RST)) 

Cleanup Script: API_2_MEP_CHEC_BSS_l.ck 
Parameter File: API_2_MEP_CHEC_BSS_1 .par 
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6.2.6.2.3 Test procedure 



Id 


Description 


API Expectation 


APDU 
Expectation 


1 




No Terminal Profile Is registered 


|\/ip pROFII F MOT AVAII 






Triggered by unformatted SMS 

Mask = 0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 


ABLE ToolkitException is 
thrown 






Offset 


= 






Length 


= 16 






2 




NULL as parameter to check 


NullPointerException is 






mask= NULL 


thrn\A/n 

11 1 1 U VV 1 1 




Q 
O 




Offset > mask.length 


Array IndGxOutOfBoundsExc 






mask 


0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 


U|JIIUI 1 lo UIIUVvll 








= 17 




4 




Offset < 


ArraylndGxOutOfBoundsExc 






: 


0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 


eption is thrown 












5 


: = 


Length > mask.length 

0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 


ArraylndexOutOfBoundsExc 
eption is thrown 






Offset 


= 






Length 


= 18 






c 
D 




Offset + length > mask.length 


Ml 1 cty 1 1 IUcaVu/U DUU 1 lUo^ALr 






Mask = 


0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 


eption is tlirown 






Offset 


= 9 






Length 


= 9 






7 


mask = 
Offset 
Length 


length = 

0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 
= 
= 






8 




Check all the Terminal Profile 


false is returned by the 






mask 


0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 


method because facility 15 is 






■ 


= 

= 16 


not supported 




9 




Check a part of the Terminal Profile 


true is returned by the 






mask = 


0xFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF7F 


method: the 16 first facilities 






Offset 
Length 


= 15 
= 2 


except facility 15 have been 
successfully checked 




10 




Check a part of the Terminal Profile 


false is returned by the 






mask = 
Offset 
Length 


0x0080 
= 
= 2 


method only facility 15 is 
checked and not supported. 





6.2.6.2.4 Test Coverage 



CRR number 


Test case number 


N1 


8,9,10 


N2 


7 


PI 


2 


P2 


3,4,5,6 


P3 


1 



6.2.6.3 Method check (short index) 

Test Area Reference: API_2_MEP_CHECS. 
6.2.6.3.1 Conformance requirement 

The method with following header shall compliant to its definition in the API. 

public static boolean check (short index) 
throws ToolkitException 

6.2.6.3.1.1 Normal execution 

• CRRNl: The method checks a facility in the handset profile: returns true if the facility is supported, false if 
facility is not supported, or if facility-index outside MEProfile data. 
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6.2.6.3.1.2 Parameters error 
No requirements. 

6.2.6.3.1.3 Context errors 

• CRRC 1 : The method shall throw ME_PROFILE_NOT_A VAIL ABLE ToolkitException if Terminal Profile data 
are not available. 



6.2.6.3.2 Test suite files 

Specific triggering: 

EVENT_STATUS_COMMAND. 
No Additional requirements for the GSM personalization: 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.6.3.3 



API_2_MEP_CHECS_1 .scr 
API_2_MEP_CHECS_1 .Java 
API_2_MEP_CHECS_1 .Idr 
API_2_MEP_CHECS_1 .ck 
API_2_MEP_CHECS_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


No Terminal Profile is registered 

Triggered by status command 
index = 1 


ME_PROFILE_NOT_AVAILABLE 
ToolkitException is thrown 




2 


Terminal Profile, Facility is supported 

index = 


true is returned by the method 




3 


Terminal Profile, Facility is not supported 

index = 15 


false is returned by the method 




4 


Facility index is outside MEProfile data 

index = 0x0099 


false is returned by the method 





6.2.6.3.4 



Test Coverage 



CRR number 


Test case number 


N1 


2,3,4 


C1 


1 



6.2.6.4 Method getValue (short indexMSB, short indexLSB) 

Test Area Reference: API_2_MEP_GVALSS. 
6.2.6.4.1 Conformance requirement 

The method with following header shall compliant to its definition in the API. 

public static short getValue ( short indexMSB, short indexLSB) 
throws ToolkitException 

6.2.6.4.1.1 Normal execution 

• CRRNl: The method returns the binary value of a parameter, delimited by two indexes, from the handset profile. 
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• CRRPl : The method shall throw BAD_INPUT_PARAMETER ToolkitException if (indexMSB > indexLSB 
+16) or (indexMSB < indexLSB) or (indexMSB < 0) or (indexLSB < 0). 



6.2.6.4.1.3 



Context errors 



• CRRCl : The method shall throw ME_PROFILE_NOT_ AVAIL ABLE ToolkitException if Terminal Profile data 
are not available. 

6.2.6.4.2 Test suite files 

Specific triggering: 

EVENT_STATUS_COMMAND 
No Additional requirements for the GSM personalization: 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 



API_2_MEP_GVALSS_1 .scr 
API_2_MEP_GVALSS_1 .Java 
API_2_MEP_GVALSS_1 .Idr 
API_2_MEP_GVALSS_1 .clr 
API_2_MEP_GVALSS_1 .par 



6.2.6.4.3 Test procedure 

TP = FF 01 D2 FO 00 00 00 00 00 00 00 00 00 8D FF. 



Id 


Description 


API Expectation 


APDU Expectation 


1 


No Terminal Profile is registered 

Triggered by status command 
indexMSB = 15, indexLSB = 


ME_PROFILE_NOT_AVAILABLE 
ToolkitException is thrown 




2 


Retrieve number of character down ME display 
in Terminal Profile which is 13 

indexMSB = 108, indexLSB = 104 


13 is returned by the method 




3 


Retrieve byte 3 and byte 4 from terminal 
profile. 

Byte 3 = OxD2, Byte 4 = OxFO 
indexMSB = 31, indexLSB =16 


0xF0D2 is returned by the method 




4 


IndexMSB is negative 

indexMSB = OxFFFF, indexLSB = OxFFFD 


BADJNPUT_PARAMETER 

ToolkitException is thrown 




5 


IndexLSB is negative 

indexMSB = 0x0002, indexLSB = OxFFFD 


BAD_INPUT_PARAMETER 
ToolkitException is thrown 




6 


indexMSB < indexLSB 

iridexMS^) 0x0002, mdex^o^) 0x000 J 


BADJNPUT_PARAMETER 
ToolkitException is thrown 




7 


IndexMSB > indexLSB + 16 

indexMSB = 0x0021, indexLSB = 0x0010 


BAD_INPUT_PARAMETER 
ToolkitException is thrown 





6.2.6.4.4 Test Coverage 



CRR number 


Test case number 


N1 


2,3 


P1 


4,5,6,7 


C1 


1 



6.2.6.5 Method copy (short startOffset, byte[] dstBuffer, short dstOffset, short 
dstLength) 

Test Area Reference: API_2_MEP_COPYS_BSS. 
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6.2.6.5.1 Conformance requirement 

The method with following header shall compliant to its definition in the API. 

public static short copy (short startOffset, byte[] dstBuffer, short dstOffset, short dstLength) 
throws ToolkitException 

6.2.6.5.1.1 Normal execution 

• CRRNl : The method copies a part of the handset profile in a buffer. 

• CRRN2: The method returns dstOffset + dstLength. 

6.2.6.5.1.2 Parameters error 

• CRRPl: If dstBuffer is null NuUPointerException is thrown. 

• CRRP2: T/'dstOf f set or dstLength parameter is negative an ArraylndexOutOf BoundsException 
exception is thrown and no copy is performed 

• CRRP3: T/'dstOf fset+dstLength is greater than dstBuffer . length, the length of the dstBuffer 
array an Array IndexOutOf BoundsException exception is thrown andno copy is performed 



6.2.6.5.1.3 



Context errors 



CRRC 1 : The method shall throw ME_PROFILE_NOT_AV AILABLE ToolkitException if Terminal Profile data 
are not available. 



6.2.6.5.2 Test suite files 

Specific triggering: 

EVENT_STATUS_COMMAND. 

No Additional requirements for the GSM personalization: 
Test Script: API_2_MEP_COPYS_BSS_l.scr 
Test Applet: API_2_MEP_COPYS_BSS_l.java 
Load Script: APl_2_MEP_COPYS_BSS_l.ldr 
Cleanup Script: API_2_MEP_C0PYS_BSS_l.clr 
Pai-ameter File: API_2_MEP_C0PYS_BSS_1 .par 



6.2.6.5.3 Test procedure 

TP = FF 01 D2 FO 01 02 00 00 00 00 00 00 00 8D FF. 



Id 


Description 


API Expectation 


APDU Expectation 


1 


No Terminal Profile is registered 

Triggered by status command 
StartOffset = 
dstBuff er . length = 6 
dstOffset = 
dstLength = 6 


ME_PROFILE_NOT_AVAILABLE 
ToolkitException is thrown 




2 


dstBuffer is null 


NuUPointerException is thrown 




3 


dstOffset > dstBuffer.length 

StartOffset = 
dstBuffer.length = 5 
dstOffset = 5 
dstLength = 1 


ArraylndexOutOf BoundsException 
is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


4 


dstOffset < 

startOffset = 
dstBuff er . length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsException 
is thrown 




5 


dstLength < 

StartOffset = 
dstBuff er . length = 5 
dstOffset = 1 
dstLength = -1 


Array 1 ndexOutOfBoundsException 
is thrown 




6 


dstLength >dstBuffer.length 

StartOffset = 
dstBuff er . length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsException 
is thrown 




7 


dstOffset + dstLength >dstBuffer. length 

StartOffset = 
dstBuff er . length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsException 
is thrown 




8 


Successful call extreme values 

StartOffset = 
dstBuff er . length = 6 
dstOffset = 
dstLength = 6 


Result of copyO is 6 




9 


Successful call any values 

StartOffset = 1 
dstBuff er . length = 20 
dstOffset = 3 
dstLength = 4 


Result of copyO is 7 




10 


Successful call, copy with length =0 

StartOffset = 

dstOffset = 20 
dstLength = 


Result of copyO is 20 




11 


Value outside MEProfile data available 

StartOffset = 13 
dstBuff er . length = 6 
dstOffset = 
dstLength = 6 


Result of copyO is 6 





6.2.6.5.4 Test Coverage 



CRR number 


Test case number 


N1 


8,9,10,11 


N3 


8,9,10,11 


PI 


2 


P2 


4,5 


P3 


3,6,7 


CI 


1 



6.2.7 Class ProactiveHandler 

6.2.7.1 Method getTheHandler 

Test Area Reference: API_2_PAH_GTHD. 
6.2.7.1.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public static ProactiveHandler getTheHandler ( ) 

throws ToolkitException 
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6.2.7.1 .1 .1 Normal execution 

• CRRNl: The method shall return the single system instance of the ProactiveHandler class. 

• CRRN2: The EnvelopeHandler is a Temporary JCRE Entry Point Object 

6.2.7.1 .1 .2 Parameter errors 
No requirements. 

6.2.7.1 .1 .3 Context errors 

• CRRC 1 : The method shall throw ToolkitException.HANDLER_NOT_AV AILABLE if the handler is busy. 

6.2.7.1.2 Test Suite files 



Test Script: 


API. 


.2. 


PAH. 


.GTHD. 


.l.scr 


Test Applet: 


API. 


.2. 


PAH. 


.GTHD. 


.l.java 


Load Script: 


API. 


.2. 


_PAH_ 


_GTHD_ 


_l.ldr 


Cleanup Script: 


API. 


.2. 


_PAH_ 


_GTHD_ 


_l.ch 


Parameter File: 


API. 


.2. 


PAH. 


.GTHD. 


.l.par 



6.2.7.1.3 Test procedure 



id 


Description 


API Expectation 


APDU Expectation 


1 


getThelHandierO twice 


The returned objects shall be the 

same 




2 


getTlieHandierO 


The reference shall be a 
ProactiveHandler 




3 


getTlieHandierO 


The reference shall not be null 





6.2.7.1 .4 Test Coverage 



CRR number 


Test case number 


N1 


1, 2, 3 


N2 


To be checked in Framework tests and insert here cross reference 


CI 


To be checked in Framework tests and insert here cross reference 



6.2.7.2 Method init 

Test Area Reference: API_2_PAH_INITBBB. 
6.2.7.2.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void init (byte type, 

byte qualifier, 
byte dstDevice) 

6.2.7.2. 1 . 1 Normal execution 

• CRRN 1 : The init() method initializes the next Proactive command in the ProactiveHandler, with Command 
details and Device Identities TLV. The source device is always the SIM Card (81h). The Comprehension 
Required flags are set. 
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• CRRN2: The Command number may take any value between Olh and FEh. 

• CRRN3: The init() method clears the ProactiveHandler before initializing it. 

• CRRN4: No TLV is selected after a call to the method. 

• CRRN5: The handler is not sent to the mobile by the init() method. 

6.2.7.2. 1 .2 Parameter errors 

No requirements. 

6.2.7.2.1.3 
No requirements. 



6.2.7.2.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.7.2.3 



Context errors 

Test Suite files 

API_2_PAH_INITBBB_1 .scr 
API_2_PAH_INrrBBB_l .java 
AP1_2_PAH_1N1TBBB_1 .Idr 
API_2_PAH_INITBBB_1 .ch 
API_2_PAH_INITBBB_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call the init() method 

type = Olh 
qualifier = 02h 
dstDevice = 03h 

Copy ProactivehHandler in a byte array (source) 
Compare the byte array 

reference = 

81h 03h xxh Olh 02h 

82h 02h 81h 03h 


source and reference are identical 




2 


Verify the command number value 


01h-FEh 




3 


Call the init() method 

type = FFh 
qualifier = FEh 
destination = FDh 

Copy ProactivelHandler in a byte array (source) 
Compare the byte array 

reference = 

81h 03h xxh FFh FEh 

82h 02h 81h FDh 


source and reference are identical 




4 


Select the 1st TLV in the handler 
Call the init() method with any value 








Call the getVaiueLengthQ method 


UNAVAILABLE_ELEMENT 
ToolkitException is thrown by 
getValueLengthO 
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6.2.7.2.4 



Test Coverage 



CRR number 


Test case number 


N1 


1,3 


N2 


2 


N3 


3 


N4 


4 


N5 


1,3 



6.2.7.3 Method initDisplayText 

Test Area Reference: API_2_PAH_INDTBB_BSS. 
6.2.7.3.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void initDisplayText (byte qualifier, 

byte dcs, 
byte[] buffer, 
short offset, 
short length) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOfBoundsExcept ion, 
ToolkitException 



6.2.7.3.1.1 



Normal execution 



• CRRNl : The method shall build a DISPLAY TEXT proactive conmiand in the ProactiveHandler, using 
quahfier, dcs and buffer parameters. Comprehension required flags are set. 

• CRRN2: A call to this method clears the handler then initializes it. 

• CRRN3 : No TLV is selected after a call to the method. 

• CRRN4: The DISPLAY TEXT command is not sent by the method. 

• CRRN5: The Command Number may take any value between Olh and FEh. 

6.2.7.3. 1 .2 Parameter errors 

• CRRPl : The method shall throw NullPointerException if buffer is nuU. 

• CRRP2: If offset or length or both would cause access outside array bounds, an 
ArraylndexOutOfBoundsException shall be thrown. 



6.2.7.3.1.3 



Context errors 



• CRRC 1 : A ToolldtException.HANDLER_0 VERFLOW shall be thrown if the ProactiveHandler is too small to 
put the requested data. 



6.2.7.3.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script; 
Parameter File: 



Test Suite files 

API_2_PAH_INDTBB_BSS_1 .scr 
API_2_PAH_INDTBB_BSS_1 .java 
API_2_PAH_INDTBB_BSS_1 .Idr 
API_2_PAH_INDTBB_BSS_1 .ch 
API_2_PAH_INDTBB_BSS_1 .par 
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6.2.7.3.3 Test procedure 



Id 






APDIJ Fynpctfltinn 


1 


NULL as parameter to buffer 

buffer = NULL 


NullPointerException is thrown 




2 


offset > buffer.length 

buffer = "Text" 
offset = 5 
length = 


ArraylndexOutOfBoundsExceptio 
n is ttirown 




3 


offset < 

buffer = "Text" 
offset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > buffer.length 

buffer = "Text" 
offset = 

length = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


offset + length > buffer.length 

buffer = "Text" 
offset = 3 
length = 2 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


length < 

buffer = "Text" 
orrset — j 
length = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Successful call, buffer Is the whole buffer 

qualifier = 
dcs = 4 

buffer = "TextA" 

offset = 
length = 5 


No exception is thrown 






Verify the command number value 


Command number between 01 h 
and FEh 




8 


Send the command 




DISPLAY TEXT Proactive 
command 

qualifier = OOh 
dcs = 4 

Text = "TextA" 


9 


Successful call, buffer Is part of a buffer with 
the end part 
Send the command 

qualifier = 
dcs = 4 

buffer = "12TextB" 
orrset — z 

length = 5 




DISPLAY TEXT Proactive 
command 

qualifier = OOh 
dcs = 4 

Text = "TextB" 


10 


Successful call, buffer is part of a buffer with 
the first part 
Send the command 

qualifier = 
dcs = 4 

buffer = "TextC12" 
offset = 
length = 5 




DISPLAY TEXT Proactive 
command 

qualifier = OOh 

dcs = 4 

lext — lextc 


11 


Successful call, buffer Is part of a buffer 
Send the command 

qualifier = 
dcs = 4 

hn-F-Fea-r — " 1 9 Tea yI- m 4 " 

offset = 2 
length = 5 




DISPLAY TEXT Proactive 
command 

qualifier = OOh 
dcs = 4 

Text = "TextD" 


12 


Successful call, qualifier = 81h 
Send the command 

qualifier = 81h 
dcs = 4 

buffer = "TextE" 
offset = 
length = 5 




DISPLAY TEXT Proactive 
command 

qualifier = 81h 
dcs = 4 

Text = "TextE" 
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Id 


Description 


API Expectation 


APDU Expectation 


13 


Successful call, DCS=0 (7 bits) 
Send the command 

qualifier = 
dcs = 

buffer = "TextF" 
offset = 
length = 5 




DISPLAY TEXT Proactive 
command 

qualifier = OOh 
dcs = 

Text = "TextF" 


14 


Successful call, DCS=8 (UCS2) 
Send the command 

qualifier = 
dcs = 8 

buffer = "TextG" 
offset = 
length = 5 




DISPLAY TEXT Proactive 
command 

qualifier = OOh 
dcs = 8 

Text = "TextG" 


15 


Call the InitDlspiayTextO method with any 

V3lUG 

Then build and send a DISPLAY TEXT 
command 

qualifier = 
dcs = 4 

buffer = "TextHTextH" 
offset = 




DISPLAY TEXT Proactive 

OUI 1 II 1 icil lu 

qualifier = OOh 
dcs = 4 

Text = "TextHTextH" 


16 


Successful call, text length is null 
Send the command 

qualifier = 
dcs = 4 

buffer = "" (not null buffer) 
offset = 
length = 




DISPLAY TEXT Proactive 
command 

qualifier = OOh 

Text String TLV = 8D 00 


17 


Select a TLV in the ProactiveHandler 
Call the InitDlspiayTextO method 
Call the getValueLengthQ method 


UNAVAILABLE_ELEMENT 
ToolkitException is thrown by 
getValueLengthQ 




18 


Successful call, buffer length = 7Eh 

qualifier = 
dcs = 4 

buffer = "UUU..." 
offset = 

length = 7Eh 




DISPLAY TEXT Proactive 

command 

Text String TLV = 
8D 7F 04 55 55... 


19 


Successful call, buffer length = 7Fh 

qualifier = 
dcs = 4 

buffer = "UUU..." 
offset = 
lengtn — /r n 




DISPLAY TEXT Proactive 
command 

Text String TLV = 8D 81 
80 04 55 55... 


20 


Successful call, buffer length = 240 

Qualifier = 
dcs = 4 

buffer = "UUU..." 
offset = 

1 ennt h = 9 4 




DISPLAY TEXT Proactive 
command 

Text String TLV = 
8D 81 Fl 04 55 55... 


21 


Call the initDisplayTextO method with a too 
long buffer 

qualifier = 
dcs = 4 

buffer = "XXXX..." 
offset = 

length = 241 


HANDLER_OVERFLOW 
ToolkitException is thrown 




22 


Call the InitDlspiayTextO without sending the 
command 




No proactive command shall 
be sent expected status is 
'9000' 
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CRR numbi^r 

111 II U III »Jvm 


Tp^t ca^p number 

1 CO I WUOC 1 1 Vi 1 1 1 ln/d 


N1 


8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20 


N2 


15 


N3 


17 


N4 


22 


N5 


7 


P1 


1 


P2 


2, 3, 4, 5, 6 


C1 


21 



6.2.7.4 Method initGetlnkey 

Test Area Reference: API_2_PAH_INGKBB_BSS. 

6.2.7.4.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void initGetlnkey (byte qualifier, 

byte dcs, 
byte [ ] buffer, 
short offset, 
short length) 
throws java . lang .NullPointerException, 

java . lang . ArraylndexOutOf BoundsException, 
ToolkitException 

6.2.7.4. 1 . 1 Normal execution 

• CRRNl: The method shall build a GET INKEY proactive command in the ProactiveHandler, using quahfier, dcs 
and buffer parameters. Comprehension Required flags are set. 

• CRRN2: A call to this method clears the handler then initializes it. 

• CRRN3 : No TLV is selected after a call to the method. 

• CRRN4: The GET INKEY conomand is not sent by the method. 

• CRRN5: The Command Number may take any value between Olh and FEh. 

6.2.7.4. 1 .2 Parameter errors 

• CRRPl : The method shall throw NullPointerException if buffer is nuU. 

• CRRPl : If offset or length or both would cause access outside array boimds, a 
ArraylndexOutOfBoundsException shall be thrown. 

6.2.7.4. 1 .3 Context errors 

• CRRCl : A ToolkitException.HANDLER_OVERFLOW shall be thrown if the ProactiveHandler is to small to 
put the requested data. 

6.2.7.4.2 Test Suite files 

Test Script: API_2_PAH_INGKBB_BSS_l.scr 

Test Applet: API_2_PAH_INGKBB_BSS_1 .java 

Load Script: API_2_PAH_INGKBB_BSS_l.ldr 

Cleanup Script: API_2_PAH_INGKBB_BSS_l.clr 
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Parameter File: API_2_PAH_INGKBB_BSS_l.par 



6.2.7.4.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


NULL as parameter to buffer 

buffer = NULL 


NullPointerException is thrown 




2 


offset > buffer.length 

buffer = "Text" 
offset = 5 


Array 1 ndexOutOfBou ndsExceptio 

II lo LI 1 1 UWI 1 




3 


offset < 

buffer = "Text" 
offset = -1 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




4 


length > buffer.length 

buffer = "Text" 
offset = 
length = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


offset + length > buffer.length 

buffer = "Text" 
offset = 3 
length = 2 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




6 


length < 

buffer = "Text" 
offset = 3 
length = -1 


Array 1 ndexOutOfBou ndsExceptio 
n is thrown 




7 


Successful call, buffer is the whole buffer 

qualifier = 
dcs = 4 

buffer = "TextA" 
offset = 
length = 5 


No exception is thrown 






Verify the command number value 


Command number between 01 h 
and FEh 




Q 
o 


wCI lU IIIC 1 II 1 icil lU 




HFT IMKFY Prnantivp 

command 

qualifier = OOh 
dcs = 4 

Text = "TextA" 


9 


Successful call, buffer is part of a buffer with 
the end part 

qualifier = 
dcs = 4 

buffer = "12TextB" 
offset = 2 
length = 5 




GET INKEY Proactive 
command 

qualifier = OOh 
dcs = 4 

Text = "TextB" 


10 


Successful call, buffer is part of a buffer with 
the first part 

qualifier = 
dcs = 4 

buffer = "TextC12" 
offset = 
length = 5 




GET INKEY Proactive 
command 

qualifier = OOh 
dcs = 4 

Text = "TextC" 


11 


Successful call, buffer is part of a buffer 
Send the command 

qualifier = 
dcs = 4 

buffer = "12TextD34" 
offset = 2 
length = 5 




GET INKEY Proactive 
command 

qualifier = OOh 
dcs = 4 

Text = "TextD" 


12 


Successful call, qualifier = 81h 

qualifier = 81h 
dcs = 4 

buffer = "TextE" 
offset = 
length = 5 




GET INKEY Proactive 
command 

qualifier = 81h 
dcs = 4 

Text = "TextE" 
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Id 


Description 


API Expectation 


APDU Expectation 


13 


Successful call, DCS=0 (7 bits) 

qualifier = 
dcs = 

buffer = "TextF" 
offset = 
length = 5 




GET INKEY Proactive 
command 

qualifier = OOh 
dcs = 

Text = "TextF" 


14 


Successful call, DCS=8 (UCS2) 

qualifier = 
dcs = 8 

buffer = "TextG" 
offset = 
length = 5 




GET INKEY Proactive 
command 

qualifier = OOh 
dcs = 8 

Text = "TextG" 


15 


Call the initGetlnkeyO method with any value 
Then build and send a GET INKEY command 

qualifier = 
dcs = 4 

buffer = "TextHTextH" 

offset = 
length = 10 




GET INKEY Proactive 
command 

qualifier = OOh 
dcs = 4 

Text = "TextHTextH" 


16 


Successful call, text length is null 
Send the command 

qualifier = 
dcs = 4 
buffer = "" 
offset = 
length = 




GET INKEY Proactive 
command 

qualifier = OOh 

Text String TLV = 8D 00 


17 


Select a TLV in the ProactiveHandler 
Call the initGetlnkeyO method 
Call the getVaiueLengthQ method 


UNAVAILABLE_ELEMENT 
ToolkitException is thrown by 
getVaiueLengthQ 




18 


Successful call, buffer length = 7Eh 

qualifier = 
dcs = 4 

buffer = "UUU..." 
offset = 
length = 7Eh 




GET INKEY Proactive 
command 

Text String TLV = 
8D 7F 04 55 55... 


19 


Successful call, buffer length = 7Fh 

qualifier = 
dcs = 4 

buffer = "UUU..." 
offset = 
length = 7Fh 




GET INKEY Proactive 
command 

Text String TLV = 8D 81 
80 04 55 55... 


20 


Successful call, buffer length = 240 

Qualifier = 
dcs = 4 

buffer = "UUU..." 
offset = 

1 f^nnt h = 9 4 




GET INKEY Proactive 
command 

Text String TLV = 
8D 81 Fl 04 55 55... 


21 


Call the initGetlnkeyO method with a too long 
buffer 

qualifier = 
dcs = 4 

buffer = "XXXX..." 
offset = 
length = 241 


HANDLER_OVERFLOW 
ToolkitException is thrown 




22 


Call the InitGetlnkeyO without sending the 
command 




No proactive command shall 
be sent expected status is 

'9000' 
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CRR numbi^r 

111 II U III »Jvm 


Tp^t ca^p number 

1 CO I WUOC 1 1 Vi 1 1 1 ln/d 


N1 


8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20 


N2 


15 


N3 


17 


N4 


22 


N5 


7 


P1 


1 


P2 


2, 3, 4, 5, 6 


C1 


21 



6.2.7.5 Method initGetlnput 

Test Area Reference: API_2_PAH_INGPBB_BSSSS. 

6.2.7.5.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void initGetlnput (byte qualifier, 

byte dcs, 
byte [ ] buffer, 
short offset, 
short length, 
short minRespLength, 
short maxRespLength) 
throws java . lang .NullPointerException, 

java . lang . ArraylndexOutOf BoundsException, 
ToolkitException 

6.2.7.5. 1 . 1 Normal execution 

• CRRNl: The method shall build a GET INPUT proactive command in the ProactiveHandler, using qualifier, 
dcs, buffer, minRespLength and maxRespLength parameters. Comprehension Required flags are set. 

• CRRN2: A call to this method clears the handler then initializes it. 

• CRRN3 : No TLV is selected after a call to the method. 

• CRRN4: The GET INPUT conmiand is not sent by the method. 

• CRRN5: The Command Number may take any value between Olh and FEh. 

6.2.7.5. 1 .2 Parameter errors 

• CRRPl : The method shall throw NullPointerException if buffer is nuU. 

• CRRP2: If offset or length or both would cause access outside array boimds, a 
ArraylndexOutOfBoundsException shall be thrown. 

6.2.7.5. 1 .3 Context errors 

• CRRCl : A ToolkitException.HANDLER_OVERFLOW shaU be thrown if the ProactiveHandler is to small to 
put the requested data. 

6.2.7.5.2 Test Suite files 

Test Script: API_2_PAH_INGPBB_BSSSS_l.scr 
Test Applet: API_2_PAH_INGPBB_BSSSS_1 .java 

Load Script: API_2_PAH_INGPBB_BSSSS_l.ldr 
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Cleanup Script: API_2_PAH_INGPBB_BSSSS_l.clr 
Parameter File: API_2_PAH_INGPBB_BSSSS_1 .par 



6.2.7.5.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


NULL as parameter to buffer 

VmtF-Fot- — MTTT T 


NullPointerException is thrown 




2 


offset > buffer.length 

buffer = "Text" 
offset = 5 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




o 

o 


OTTSet < u 

buffer = "Text" 
offset = -1 


Array 1 ndexOutOfBoundsExceptio 

n is thrown 




4 


length > buffer.length 

buffer = "Text" 
offset = 
length = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


offset + length > buffer.length 

buffer = "Text" 
offset = 3 
length = 2 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


length < 

buffer = "Text" 
offset = 3 
length = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Successful call, buffer Is the whole buffer 

qualifier = 
dcs = 4 

burrer — iextA 
offset = 

length = 5 
minRespLength = OOh 
maxRespLength = FFh 


No exception is thrown 






Verify the command number value 


Command number between 01 h 
and -FEh 




8 


Send the command 




GET INPUT Proactive 
command 

qualifier = OOh 
dcs = 4 

Text = "Text A" 
Min Length = OOh 
Max Length = FFh 


9 


Successful call, buffer is part of a buffer with 
the end part 
Send the command 

qualifier = 
dcs = 4 

buffer = "12TextB" 
offset = 2 
length = 5 
minRespLength = lOh 
maxRespLength = FFh 




GET INPUT Proactive 
command 

qualifier = OOh 
dcs = 4 
isxiz — iexu-D 
Min Length = lOh 
Max Length = FFh 


10 


Successful call, buffer is part of a buffer with 
the first part 
Send the command 

qualifier = 
dcs = 4 

buffer = "TextC12" 
offset = 
length = 5 
minRespLength = FFh 
maxRespLength = FFh 




GET INPUT Proactive 
command 

qualifier = OOh 
dcs = 4 

Text = "TextC" 
Min Length = FFh 
Max Length = FFh 
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Id 


Description 


API Expectation 


APDU Expectation 


11 


Successful call, buffer is part of a buffer 
Send the command 

qualifier = 
dcs = 4 

buffer = "12TextD34" 
offset = 2 
length = 5 
minRespLength = OOh 
maxRespLength = OOh 




GET INPUT Proactive 
command 

qualifier = OOh 
dcs = 4 

Text = "TextD" 
Min Length = OOh 
Max Length = OOh 


12 


Successful call, qualifier = Bih 

cju slifisr" = 81h 
dcs = 4 

buffer = "TextE" 
offset = 
length = 5 
minRespLength = OOh 
maxRespLength = lOh 




GET INPUT Proactive 
command 

qualifier = 81h 
dcs = 4 

Text = "TextE" 
Min Length = OOh 
Max Length = lOh 


13 


Successful call, DCS=0 (7 bits) 

cju slifi-Gi" — 
dcs = 

buffer = "TextF" 
offset = 
length = 5 
minRespLength ^ lOh 
maxRespLength = lOh 




GET INPUT Proactive 
command 

qualifier = OOh 
dcs = 

Text = "TextF" 
Min Length = lOh 
Max Length = lOh 


14 


Successful call, DCS=8 (UCS2) 

cjuS-l i fi s IT = 
dcs = 8 

buffer = "TextG" 
offset = 
length = 5 
minRespLength = OOh 
maxRespLength = FFh 




GET INPUT Proactive 
command 

qualifier = OOh 
dcs = 8 

Text = "TextG" 
Min Length = OOh 
Max Length = FFh 


15 


Call the InltGetinputQ method with any value 
Then build and send a GET INPUT command 

qualifier ^ 
dcs = 4 

buffer = "TextHTextH" 

offset = 
length = 10 
minRespLength = OOh 
maxRespLength = lOh 




GET INPUT Proactive 
command 

qualifier = OOh 
dcs = 4 

Text = "TextHTextH" 
Min Length = OOh 
Max Length = lOh 


16 


Successful call, text length is null 
Send the command 

qualifier = 
dcs = 4 
buffer = "" 
offset = 
length = 
minRespLength - OOh 
maxiiesp^engrn ICn 




GET INPUT Proactive 
command 

qualifier = OOh 

Text String TLV = 8D 00 

Min Length = OOh 

Max Length = lOh 


17 


Select a TLV in the ProactiveHandler 
Call the initGetlnputO method 
Call the getVaiueLengthQ method 


UNAVAILABLE_ELEMENT 
ToolkitException is thrown by 
getVaiueLengthQ 




18 


Successful call, buffer length = 7Eh 

qualifier = 
dcs = 4 

buffer = "UUU..." 
offset = 
length = 7Eh 
minRespLength = OOh 
maxRespLength = lOh 




GET INPUT Proactive 
command 

Text String TLV = 
8D 7F 04 55 55... 
Min Length = OOh 
Max Length = lOh 
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Id 


Description 


API Expectation 


APDU Expectation 


19 


Successful call, buffer length = 7Fh 

qualifier = 
dcs = 4 

buffer = "UUU..." 
offset = 
length = 7Fh 
minRespLength = OOh 
maxRespLength = lOh 




GET INPUT Proactive 
command 

Text String TLV = 8D 81 
80 04 55 55... 
Min Length = OOh 
Max Length = lOh 


20 


Successful call, buffer length = 236 

Qualifier = 
dcs = 4 

buffer = "UUU..." 
offset = 
length = 236 
minRespLength = OOh 
maxRespLength = lOh 




GET INPUT Proactive 
command 

Text String TLV = 
8D 81 ED 04 55 55... 


21 


Call the initGetlnputO method with a too long 
buffer 

qualifier = 
dcs = 4 

buffer = "XXXX..." 
offset = 
length = 237 
minRespLength = OOh 
maxRespLength = lOh 


HANDLER_OVERFLOW 
ToolkitException is thrown 




22 


Call the InitGetlnputO without sending the 
command 




No proactive command shall 
be sent expected status is 
'9000' 



6.2.7.5.4 Test Coverage 



CRR number 


Test case number 


Ml 


8, 9, 10, 11, 12, 13, 14, 15, 16, 18, 19, 20 


N2 


15 


N3 


17 


N4 


22 


N5 


7 


PI 


1 


P2 


2, 3, 4, 5, 6 


CI 


21 



6.2.7.6 Method send 

Test Area Reference: API_2_PAH_SEND. 
6.2.7.6.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte sendO 

6.2.7.6. 1 . 1 Normal execution 

• CRRNl : The send() method send the current proactive command to the mobile. 

• CRRN2: The returned byte is equal to general result of the command (first byte of Result TLV in Terminal 
Response). 

• CRRN3: The handler remains unchanged after a call to send() method until the use of imtXX() or appendTLV(). 

• CRRN4: There is no invocation of select() or deselect() method. 

• CRRN5: A pending toolkit applet transaction at the method invocation is aborted. 
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6.2.7.6. 1 .2 Parameter errors 

No requirements. 

6.2.7.6.1.3 Context errors 



• CRRC 1 : A ToolkitException.UNAVAILABLE_ELEMENT shall be thrown is 
missing in Terminal Response. 

• CRRC2: A ToolkitException.OUT_OF_TLV_BOUNDARIES shall be thrown 
missing in the Result Simple TLV in Terminal Response. 
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the Result Simple TLV is 
if the general result byte is 



6.2.7.6.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.7.6.3 



Test Suite files 

API_2_PAH_SEND_1 .scr 
API_2_PAH_SEND_1 .Java 
API_2_PAH_SEND_1 .Idr 
API_2_PAH_SEND_1 .clr 
API_2_PAH_SEND_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a DISPLAY TEXT command 

qualifier = OOh 
buffer = 'Text' 




DISPLAY TEXT Proactive 
command 


2 


Terminal Response with General Result = GO 

Result TLV = 03 01 00 (command performed 
successfully) 


Result of sendO is OOh 




3 


Build and send a DISPLAY TEXT command 

qualifier = OOh 
dcs = 04h 
buffer = 'Text' 




DISPLAY TEXT Proactive 
command 


4 


Terminal Response with General Result = 01, 
without Additional Information on result 

Result TLV = 03 01 01 (command performed 

with partial comprehension) 


Result of sendQ is 01 h 




5 


Build and send a DISPLAY TEXT command 

qualifier = OOh 
dcs = 04h 
buffer = 'Text' 




DISPLAY TEXT Proactive 
command 


6 


Terminal Response with General Result = 01, 
with Additional Information on result 

Result TLV = 03 02 01 55 (command 
performed with partial comprehension) 


Result of send() is 01 h 




7 


Build and send a DISPLAY TEXT command 

qualifier = OOh 
dcs = 04h 
buffer = 'Text' 




DISPLAY TEXT Proactive 
command 


8 


Terminal Response with General Result = 02 

Result TLV = 03 04 02 65 43 21 (Missing 
information) 


Result of sendO is 02h 




9 


Build and send a 7Fh byte command 
(DISPLAY TEXT) 

qualifier = OOh 
dcs = 04h 
buffer = "UUUUU..." 
length = 73h 




DISPLAY TEXT Proactive 
command 

BER-TLV = DO 7F 

Text String TLV = 8D 74 

04 55 55 55... 
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Id 


Description 


API Expectation 


APDU Expectation 


10 


Build and send a SOh byte command (DISPLAY 
TEXT) 

qualifier = OOh 
dcs = 04h 
buffer = "UUUUU..." 
length = 74h 




DISPLAY TEXT Proactive 
command 

BER-TLV = DO 81 8 
Text String TLV = 8D 75 
04 55 55 55... 


11 


Build and send a maximum length command 
(length of the handler should be 253) 

DISPLAY TEXT: 
Qualifier = 
dcs = 4 

buffer = "UUU..." 
offset = 
length = 240 




DISPLAY TEXT Proactive 
command 

BER-TLV = DO 81 FD 
Text String TLV = 8D 81 
Fl 04 55 55... 


12 


Verify that the Proactive Handler is not 
modified after a send() 
Build a DISPLAY TEXT command 

Copy ProactiveHandler to source byte array 

Send command 

Copy ProactiveHandler to destination byte 
array 

Compare source and destination 


Source and destination are 
identical 




13 


Build and send a DISPLAY TEXT command 
Verify there is no invocation of select() or 
deselectO method. 




DISPLAY TEXT Proactive 

command 


14 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 2 Result TLV 

1st Result TLV = 03 02 02 12 

2nd Result TLV = 03 03 03 34 56 


Result of sendQ is 02h 




15 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response without Result Simple TLV 


ToolkitException.UNAVAILABLE_ 
ELEMENT is thrown by sendQ 




16 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response without general result byte 
in the Simple TLV 

Result TLV = 03 00 


ToolkitException.OUT_OF_TLV_ 
BOUNDARIES is thrown by 
sendQ 





6.2.7.6.4 Test Coverage 



CRR number 


Test case number 


N1 


1,3, 5, 7, 9, 10, 11, 12, 13, 14 


N2 


2, 4, 6, 8, 14 


N3 


12 


N4 


13 


N5 


To be checked in Framework tests and insert here cross reference 


CI 


15 


C2 


16 
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6.2.7.7 Method getLength 

Test Area Reference API_2_PAH_GLEN. 
6.2.7.7.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getLength () 

throws ToolkitException 

6.2.7.7.1.1 Normal execution 

• CRRNl : returns the length in bytes of the TLV list. 

6.2.7.7. 1 .2 Parameter errors 

No requirements. 

6.2.7.7. 1 .3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 



6.2.7.7.2 Test Suite files 



Test Script: 


API. 


.2. 


_PAH. 


_GLEN_ 


_l.scr 


Test Applet: 


API. 


.2. 


_PAH. 


_GLEN_ 


_l.java 


Load Script: 


API. 


.2. 


PAH. 


.GLEN. 


.l.ldr 


Cleanup Script: 


API. 


.2. 


PAH. 


.GLEN. 


.l.clr 


Parameter File: 


API. 


.2. 


PAH. 


.GLEN. 


.l.par 



6.2.7.7.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Clear the handler 

getLength ( ) 


Result of getLengthO Is 




2 


Call the InitQ method 

getLength ( ) 


Result of getLengthO Is 9 




3 


Call the InitDlsplayTextO method, with buffer 
length = 240 

getLength ( ) 


Result of getLengthO Is 253 




4 


Build a 7Fh Proactive Handler 

getLength ( ) 


Result of getLengthO Is 7Fh 




5 


Build a 80h Proactive Handler 

getLength ( ) 


Result of getLengthO Is BOh 





6.2.7.7.4 Test Coverage 



CRR number 


Test case number 


N1 


1, 2, 3, 4, 5 


01 


Does not apply for Proactive Handler 
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6.2.7.8 Method copy 

Test Area Reference API_2_PAH_COPY_BSS. 
6.2.7.8.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short copy (byte [] dstBuffer, 
short dstOffset, 
short dstLength) 
throws java . lang .NullPointerException, 

java . lang .Array IndexOutOfBoundsExcept ion, 
ToolkitException 

6.2.7.8.1.1 Normal execution 

• CRRNl : copies the simple TLV Ust contained in the handler to the destination byte array. 

• CRRN2: returns dstOffset + dstLength. 

6.2.7.8.1 .2 Parameter errors 

• CRRP 1 : if dstBuffer is nuU a NullPointerException is thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative, 
an ArraylndexOutOfBoundsException is thrown. 

• CRRP3: if dstLength is grater than the length of the simple TLV List, an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException. OUT_OF_TLV_BOUND ARIES. 



6.2.7.8.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shidl be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 



6.2.7.8.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.7.8.3 



Test Suite files 

API_2_PAH_COPY_BSS_l.scr 
API_2_PAH_COPY_BSS_l .java 
AP1_2_PAH_C0P Y_BSS_1 .Idr 
API_2_PAH_COPY_BSS_l .ch 
API_2_PAH_COPY_BSS_l .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


NULL as parameter to dstBuffer 


NullPointerException is thrown 




2 


Call the InitQ metfiod 








DstOffset > dstBuffer.length 

dstBuff er . length = 5 
dstOffset = 6 
dstLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 5 

dstOffset = -1 
dstLength = 1 


Array 1 ndexOutOfBoundsExceptio 
n is thrown 




4 


DstLength > dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


Array 1 ndexOutOfBoundsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


C 

O 


Hctr^ffcot J- HctI Atmth ^ HctRiiffai* lannth 

uoiwiioci + uoiLciiyiii > uoiDuiici.iciiyiii 

dstBuff er . length = 5 
dstOffset = 3 
dstLength = 3 


Ml idyll lUcXVJULL^I DUUf lUbCXOcpilU 

n is thrown 




D 


usiLengin < u 

dstBuff er . length = 5 

dstOffset = 
dstLength = -1 


Array IndexOutOfBoundsExcGptio 
n is thrown 




7 


uoiLsngin > icnyin ot ins siiiipic i lv iisi 

dstBuff er . length = 10 
dstOffset = 
dstLength = 10 


1 ooiKitnxcepiion.'^ij i _\Jr i l v 

DWUIMU/AmCO lo LIIIUWII 




8 


Successful call, dstBuffer is the wliole buffer 

dstBuff er . length = 9 
dstOffset = 
dstLength = 9 


Result of copyO is 9 




9 


Compare the buffer 


Result of arrayCompareO is 




10 


Successful call, dstBuffer is part of a buffer 

dstBuff er . length = 15 
dstOffset = 3 
dstLength = 9 


Result of copyO is 12 




11 


Compare the whole buffer 


Result of arrayCompareO is 




12 


Successful call, dstBuffer is part of a buffer 

dstBuff er . length = 15 
dstOffset = 3 
dstLength = 6 


Result of copyO is 9 




13 


Compare the whole buffer 


Result of arrayCompareO is 





6.2.7.8.4 Test Coverage 



CRR number 


Test case number 


N1 


9, 11,13 


N2 


8, 10, 12 


PI 


1 


P2 


2, 3, 4, 5, 6 


P3 


7 


CI 


Does not apply for ProactiveHandler 



6.2.7.9 Method findTLV 

Test Area Reference API_2_PAH_FINDBB. 
6.2.7.9.1 Conformance requirement 

The method with following header shall be compliant to its deiinition in the APT 

public byte findTLV (byte tag, byte occurrence) 
throws ToolkitException 

6.2.7.9. 1 . 1 Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of the TLV hst (handler buffer): 

• CRRNl: the method is successful if the required occurrence exists then the corresponding TLV becomes current. 

• CRRN2: if the method is successful then it returns TLV_FOUND_CR_SET when Comprehension Required flag 
is set. 

• CRRN3: if the method is successful then it returns TLV_FOUND_CR_NOT_SET when Comprehension 
Required flag is not set. 

• CRRN4: if the required occurrence of the TLV element does not exist, the current TLV is no longer defined and 
TLV_NOT_FOUND is returned. 
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• CRRN5: The search method is comprehension required flag independent. 

6.2.7.9. 1 .2 Parameter errors 

• CRRPl : if an input parameter is not vahd (e.g. occurrence = 0) an instance of ToolkitException shall be thrown. 
The reason code shall be ToolkitException BAD_INPUT_PARAMETER. 

6.2.7.9.1.3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shidl be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 



6.2.7.9.2 Test Suite files 



Test Script: 


API. 


.2. 


PAH. 


.FINDBB. 


.l.scr 


Test Applet: 


API. 


.2. 


PAH. 


.FINDBB. 


.l.java 


Load Script: 


API. 


_2_ 


_PAH 


_FINDBB_ 


_l.ldr 


Cleanup Script: 


AP1_ 


_2_ 


_PAH 


_F1NDBB_ 


_l.ch 


Parameter File: 


API. 


.2. 


PAH. 


.FINDBB. 


.l.par 



6.2.7.9.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


initialize the handler 








Invalid input parameter 

Occurrence = 


1 OOlklttXCeptlon.DAIJ_INrU l_rA 
RAMETER is thrown 




2 


Call the initO method 








Search 1st TLV 

Tag = Olh 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




3 


Call the getVaiueLengthQ method 


Result is 03h 




4 


Search 2nd TLV 

Tag = 02h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




5 


Call the getValueLengthO method 


Result is 02h 




6 


Select a TLV (tag 02h) 








Search a wrong tag 

Tag = 03h 
Occurrence = 1 


Result is TLV_NOT_FOUND 




7 


Call the getValueLengthO method 


ToolkitException. UNAVAILABLE_ 
ELEMENT Is thrown. 




8 


Search a tag with wrong occurrence 

Tag = Olh 
Occurrence = 2 


Result is TLV_NOT_FOUND 




9 


Call the getValueLengthO method 


ToolkitException. UNAVAILABLE_ 
ELEMENT is thrown. 




10 


Append a TLV with tag=02h 








Search the TLV 

Tag = 02h 
Occurrence = 2 


Result Is 

TLV_FOUND_CR_NOT_SET 




11 


Append a TLV with tag=04h 








Search the TLV 

Tag = 04h 
Occurrence = 1 


Result Is 

TLV_FOUND_CR_NOT_SET 




12 


Search tag 81 h 

Tag = 81h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 




13 


Search tag 84h 

Tag = 84h 
Occurrence = 1 


FRssult is 

TLV_FOUND_CR_NOT_SET 
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6.2.7.9.4 Test Coverage 



CRR number 


Test case number 


N1 


3,5 


N2 


2, 4 


N3 


10, 11 


N4 


6, 7,8, 9 


N5 


12, 13 


P1 


1 


C1 


Does not apply for Proactive Handler 



6.2.7.10 Method getValueLength 

Test Area Reference API_2_PAH_GVLE. 
6.2.7.10.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getValueLength ( ) 

throws ToolkitException 

6.2.7.10.1.1 Normal execution 

• CRRNl : gets and returns the binary length of the value field for the last TLV element which has been foimd in 
the handler. 

6.2.7.10.1.2 Parameter errors 
No requirements. 

6.2.7.10.1.3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code 
shall be ToolkitException UNAVAILABLE_ELEMENT. 



6.2.7.10.2 Test Suite files 



Test Script: 


API. 


_2_ 


_PAH 


_GVLE_ 


_l.scr 


Test Applet: 


API. 


_2_ 


_PAH_ 


_GVLE_ 


_l.java 


Load Script: 


APL 


_2_ 


_PAH 


_GVLE_ 


_l.ldr 


Cleanup Script: 


API. 


.2. 


.PAH_GVLE_ 


.l.clr 


Parameter File: 


API. 


.2. 


PAH. 


.GVLE_ 


.l.par 
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6.2.7.10.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call the initQ method 








getValueLength ( ) 


ToolkitException . UNAVAI LABLE_ 
ELEMENT is thrown 




2 


Call the appendTLVQ method 

tag = OD 
valueOffset = 

valueLength = 








Search TLV ODh (Text String TLV) 








getValueLength ( ) 


Result is OOh 




3 


Call the InitDisplayTextQ method 

length = 1 (+ dcs byte) 








Search TLV ODh (Text String TLV) 








getValueLength ( ) 


Result is 02h 




4 


Call the InitDisplayTextQ method 
length = 7Eh (+ dcs byte) 








Search TLV ODh (Text String TLV) 








getValueLength ( ) 


Result is 7Fh 




5 


Call the InitDlsplayTextO method 

length = 7Fh (+ dcs byte) 








Search TLV ODh (Text String TLV) 








getValueLength ( ) 


Result is BOh 




6 


Call the InitDlsplayTextO method 

length = FOh (maximum text length) 








Search TLV ODh (Text String TLV) 








getValueLength ( ) 


Result is F1h 





6.2.7.10.4 Test Coverage 



CRR number 


Test case number 


N1 


2, 3, 4, 5, 6 


01 


Does not apply for Proactive Handler 


02 


1 



6.2.7.11 Method getValueByte 

Test Area Reference API_2_PAH_GVBYS. 
6.2.7.1 1.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getValueByte (short valueOffset) 
throws Tooll^itException 

6.2.7.1 1 .1 .1 Normal execution 

• CRRNl: Gets a byte from the last TLV element which has been found in the handler and returns its value (1 
byte). 

6.2.7.11.1.2 Parameter errors 

• CRRPl : if valueOffset is out of the current TLV an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException OUT_OF_TLV_BOUNDARIES. 

6.2.7.1 1 .1 .3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 
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• CRRC2: in case of unavailable TLV element an instance of TooUdtException shall be thrown. The reason code 
shall be TooUdtException UNAVAILABLE_ELEMENT. 



6.2.7.11.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.7.11.3 



Test Suite files 

API_2_PAH_GVBYS_l.scr 
API_2_PAH_GVBYS_1 .Java 
API_2_PAH_GVB YS_1 .Idr 
API_2_PAH_GVB YS_1 .ch 
API_2_PAH_GVB YS_1 .par 

Test procedure 



1^ 

lu 


Description 


API Expectation 


Aruu bxpectaiion 


1 


Caii the init() method 

LY^y — rrll 

qualifier = FEh 
destination = FDh 








getVaiueByte(O) 


ToolkitException.UNAVAILABLE_ 
ELEMENT is thrown 




2 


Search TLV 01 h (Command Details TLV) 








get vai ueByte(3) 


T00lKltExceptl0n.OUT_Or_TLV_ 
DUUNUAKItb IS thrown 




3 


Search TLV 01 h (Command Details TLV) 








getValueByte(2) 


Result is FEh (qualifier) 




4 


Search TLV 02h (Device Identities TLV) 








getValueByte(O) 


Result Is 81 h (Source) 




5 


InitDispiayTextQ 

buffer = 00 01 ... 7D 
length = 7Eh 

Search TLV ODh (Text String TLV) 








getValueByte(7E) 


Result is 7Dh 




6 


InitDlspiayTextO 

buffer = 00 01 ... 7D 7E 
length = 7Fh 

Search TLV ODh (Text String TLV) 








getValueByte(7E) 


Result Is 7Dh 




7 


getValueByte(7F) 


Result Is 7Eh 




8 


InitDlspiayTextO 

buffer = 00 01 ... EF 
length = FOh 

Search TLV ODh (Text String TLV) 








getValueByte(FO) 


Result is EFh 





6.2.7.11.4 Test Coverage 



CRR number 


Test case number 


N1 


3, 4, 5, 6, 7, 8 


P1 


2 


01 


Does not apply for Proactive Handler 


02 


1 
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6.2.7.12 Method copyValue 

Test Area Reference API_2_PAH_CPYVS_BSS. 
6.2.7.12.1 Conformance requirement 

The method with following header shall be compliant with its definition in the API. 

public short copyValue ( short valueOffset, 

byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws java . lang .NullPointerException, 

java . lang .Array IndexOutOfBoundsExcept ion, 
ToolkitException 

6.2.7.12.1.1 Normal execution 

• CRRNl : copies a part of the last TLV element which has been found, into a destination, buffer. 

• CRRN2: returns dstOffset + dstLength. 

6.2.7.12.1 .2 Parameter errors 

• CRRPl : if dstBuffer is null NullPointerException is thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException is thrown. 

• CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shaU be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 



6.2.7.12.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code 
shall be ToolkitException UNAVAILABLE_ELEMENT. 



6.2.7.12.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.7.12.3 



Test Suite files 

API_2_PAH_CPYVS_BSS_1 .scr 
API_2_PAH_CPYVS_BSS_1 .java 
API_2_PAH_CPYVS_BSS_1 .Idr 
API_2_PAH_CPYVS_BSS_1 .ck 
API_2_PAH_CPYVS_BSS_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


initialize the handier 
Select a TLV 








copyValue with a null dstBuffer 


NullPointerException is thrown 




2 


initDlspiaylextO with length = 15 

Select Text String TLV 








dstOffset > dstBuffer.iength 

dstBuff er . length = 5 
dstOffset = 6 
dstLength = 


ArraylndexOutOfBoundsExceptIo 
n is thrown 





ETSI 



3GPP TS 11.13 version 8.2.1 Release 1999 



159 



ETSI TS 101 955 V8.2.1 (2003-04) 



Id 


Description 


API Expectation 


APDU Expectation 


O 
O 


dstBuff er . length = 5 
dstOffset = -1 
dstLength = 1 


Array inucXVjUTLJTDOunastxcGpiio 
n is thrown 




A 


QSiLBnyin >asiDUTTer.iengin 

dstBuf f er . length = 5 

dstOffset = 
dstLength = 6 


Array IndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength >dstBuffer.length 

dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n IS inrown 




6 


dstLength < 

dstBuf fer . length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


initDisplayTextO with length = 5 

Select Text String TLV 








valueOffset > Text String Length 

valueOffset = 7 
dstBuf fer . length = 15 
asruiiser — u 
dstLength = 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


[Select Text String TLV] 

valueOffset < 
valueOffset = -1 
dstBuf fer . length = 15 
asuurrsen — u 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


[Select Text String TLV] 

dstLength > Text String length 
valueOffset = 
dstBuf fer . length = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




\ U 


loeieci lexioiring ilvj 

VCliLlC'—'^^OtJU l,J_]t^il>-jl,il . — Lily 

length 

valueOffset ^ 2 
dstBuf fer . length = 15 
dstOffset = 
dstLength = 5 


1 OOlKltbXCGptlOn.UU 1 _Ur_ 1 L V_ 
DUUINUMrilto IS Tiirown 




11 


Initialize the handler 








copyValueO 


ToolkitException . UNAVAI LABLE 
ELEMENT is thrown 




12 


initDisplayTextO 

dcs = 4 

buffer = 00 01 ... OF 
Select Text String TLV 








Surr(*^^ful call 

valueOffset = 
dstBuf fer . length = 17 
dstOffset = 
dstLength = 17 






13 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




14 


Initialize dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

valueOffset = 2 
dstBuf fer . length = 20 

QSLUlLSeL — o 

dstLength = 12 


Result of copyValueO is 15 




15 


Compare buffer 

buffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 


Result is OOh 
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CRR number 


Test case number 


N1 


13, 15 


N2 


12, 14 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7, 8, 9, 10 


C1 


Does not apply for Proactive Handler 


C2 


11 



6.2.7.13 Method compareValue 

Test Area Reference API_2_PAH_CPRVS_BSS. 

6.2.7.13.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte compareValue (short valueOffset, 

byte [ ] compareBuf fer, 
short compareOf f set, 
short compareLength) 
throws java . lang .NullPointerException, 

java . lang .Array IndexOutOfBoundsExcept ion, 
ToolkitException 

6.2.7.13.1.1 Normal execution 
Compares the last found TLV element with a buffer: 

• CRRNl : returns if identical. 

• CRRN2: returns -1 if the first miscomparing byte in simple TLV List is less than that in compareBuffer. 

• CRRN3: returns 1 if the first miscomparing byte in simple TLV List is greater than that in compareBuffer. 

6.2.7.13.1 .2 Parameter errors 

• CRRPl: if compareBuffer is nuU NullPointerException shall be thrown. 

• CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if 
compareLength is negative ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

6.2.7.13.1.3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code 
shaU be ToolkitException UNAVAILABLE_ELEMENT. 

6.2.7.13.2 Test Suite files 

Test Script: API_2_PAH_CPRVS_BSS_l.scr 

Test Applet: API_2_PAH_CPRVS_BSS_Ljava 

Load Script: API_2_PAH_CPRVS_BSS_l.ldr 

Cleanup Script: API_2_PAH_CPRVS_BSS_l.clr 
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Parameter File: API_2_PAH_CPRVS_BSS_l.par 



6.2.7.13.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialize the handler 
Select a TLV 








compareVaiueQ with a null compareBuffer 


NullPointerException is thrown 




2 


InitDispiayTextO with length = 15 

Select Text String TLV 








compareOffset > compareBuffer.length 

compareBuff er . length = 5 
compareOffset = 6 
compareLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


comDarpOffspt ^ Q 

compareBuffer.length = 5 
compareOffset = -1 
compareLength = 1 


ArravlnrlpxOi itOf Rni inrl^iFYPPntin 

n is thrown 




4 


compareLength >compareBuffer.length 

compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + compareLength 
>compareBuffer.length 

compareBuffer.length = 5 
compareOffset ^ 3 
compareLength = 3 


Array 1 ndexOutOfBoundsExceptio 
n is thrown 




6 


compareLength < 

compareBuffer.length = 5 

compareOffset = 
compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


initDi^DlavTpxtn with Ipnath — 5 

1 1 II i&^i^uici y icAiyy ¥viiii i^iiuiii w 

Select Text String TLV 








valueOffset > Text String Length 

valueOffset = 7 
compareBuffer.length = 15 
compareOffset = 
compareLength = 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


[Select Text String TLV] 

valueOffset < 
valueOffset = -1 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


[Select Text String TLV] 

compareLength > Text String length 
IT'S T nf^n-P-Fc-f^i- = n 
compareBuffer.length = 15 
compareOffset = 
compareLength = 7 


ToolkitException.OUT_OF_TLV_ 
BOUNDARIES is thrown 




10 


[Select Text String TLV] 

valueOffset + compareLength > Text String 
length 

valueOffset = 2 
compareBuffer.length = 15 
compareOffset = 
compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Initialize the handler 








compareVaiueQ 


ToolkitException.UNAVAILABLE_ 
ELEMENT is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


12 


InitDisplayTextQ 

dcs = 4 

buffer = 00 01 ... OF 
Select Text String TLV 








lnitiAli7p mtnnflrpRiiffpi' 

compareBuffer = 
04 00 01 ... OF 









Compare buffers 

valueOffset = 
compareOf f set = 


Result is OOh 




1 3 


Initialize coirmareRuffer 

compareBuffer = 
04 00 01 02 03 

04 05 06 07 08 

05 OA OB OC OD 
OE 10 








Compare buffers with same parameters 


Result is -1 




14 


Initialize compareBuffer 

compareBuffer = 
3 01 ... OF 








Comnare buffers with same narameters 

III I^Cll ^7 i^U 1 1^71 w TV 1 & I 1 wdl 1 1 w l^dl CAI 1 l^^lwl w 


Qpci lit .1.1 




15 


Initialize compareBuffer 

compareBuffer = 
55 55 55 01 02 
D"^ 04 ns Of, m 

UJ> U4 UO UD <J 1 

08 09 OA OB OC 
55 55 55 55 55 








Compare buffers 

valueOffset = 2 
compareOf f set = 3 

L.UlLLf-'CL J- fc; J-iCl iy I— 1 i — i Z. 


Result is OOh 




1 6 


Initialize coirmareBuffer 

1 1 1 1 &IC11 1^^^ W^^l 1 ll^dl ^^mJ^M 1 1 wl 

compareBuffer = 
55 55 55 02 01 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Comnare buffers with same narameters 

III I^Cll i^U 1 l^^l w TV 1 & I 1 wdl 1 1 w l^dl CAI 1 l^^lwl w 


Ppci lit ic -1 




17 


Initialize compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OA OD 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 




18 


Initialize compareBuffer 

compareBuffer = 
55 55 55 99 03 
03 04 05 06 07 

08 09 OA OB OC 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 
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CRR number 

1111 II U III l^^^l 


Tp^t ra^p number 

I I VWO^ ■IWIIII-^d 


N1 


12, 15 


N2 


13, 16 


N3 


14, 17, 18 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7, 8, 9, 10 


C1 


Does not apply for Proactive Handler 


C2 


11 



6.2.7.14 Method findAndCopyValue(byte tag, byte[] dstBuffer, short valueOffset) 

Test Area Reference API_2_PAH_FACYB_BS. 
6.2.7.14.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short f indAndCopyValue (byte tag, 

byte[] dstBuffer, 
short dstOffset) 
throws java . lang .NullPointerException, 

java . lang .Array IndexOutOfBoundsExcept ion, 
ToolkitException 

6.2.7.14.1.1 Normal execution 

• CRRN 1 : looks for the first occurrence of a TLV element from the beginning of a TLV list and copy its value into 
a destination buffer. 

• CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 

TLV is no longer defined. 



CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + length of the 
copied value is returned. 



• CRRN4: The search method is comprehension required fiag independent. 

6.2.7.14.1 .2 Parameter errors 

• CRRPl : if dstBuffer is nuU NullPointerException shall be thrown. 

• CRRP2: if dstOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall be 
thrown. 

6.2.7.14.1.3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

6.2.7.14.2 Test Suite files 

Test Script: API_2_PAH_FACYB_BS_Lscr 

Test Applet: API_2_PAH_FACYB_BS_1 .java 

Load Script: API_2_PAH_FACYB_BS_Lldr 

Cleanup Script: API_2_PAH_FACYB_BS_Lch 

Parameter File: API_2_PAH_FAC YB_B S_ 1 .par 
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6.2.7.14.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialize the handler 








FlndAndCopyValueQ with a null dstBuffer 


NullPointerException is thrown 




2 


InitDisplayTextO with length = 15 








usivjiTseT > uSTDUTTer.iengin 

tag = ODh 

dstBuff er . length = 20 

dstOffset = 21 


Array 1 ndexOutOfBoundsExceptio 
n is thrown 




o 


dstBuff er . length = 20 
dstOffset = -1 


A rrQ\/l nrlovOi itOf R(*vi inrleP v/^or\f irt 
Ml 1 cty 11 lUUXV^ULwIOUUi IUoCALfC|JllU 

n 1*5 thrnwn 

II lO LI 1 1 W Vv 1 1 




4 


length > dstBuffer.length 

dstBuff er . length = 15 
dstOffset = 


ArraylndexOutOfBoundsExceptlo 
n is thrown 




5 


DstOffset + length >dstBuffer. length 

DstBuffer.length = 20 
DstOffset = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


initDisplayTextQ 








Select a TLV (tag 02h) 








findAndCopyValueQ 

tag = 03h 


Tooll<ltException . UNAVAII_ABLE_ 
ELEIVIENT is thrown 






Call the getValueLengthO method 


ToolkitExceptlon . UNAVAI U\BLE_ 
ELEIVIENT is thrown. 




7 


initf^ienlavTovtA 
II iiiuid|jiciy 1 CAi^^ 

dcs = 4 

buffer = 00 01 ... OF 








Successful call 

Tag = ODh 

DstBuffer.length = 17 
DstOffset = 


Result of findAndcopyValueO is 
17 




8 


Compare buffer 

buffer = 04 00 01 ... OF 


Result Is OOh 




9 


initialize dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

dstBuffer.length = 20 
dstOffset = 2 


Result of findAndcopyValueO is 
19 




10 


Compare buffer 

buffer" = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 


Result is OOh 




-| -| 


initDi^nlflvTpytn 

dcs = 4 

buffer = 00 01 ... OF 








annpnH a Or\f\ TpYt ^trillfl TLV 








Successful call 

tag = ODh 

dstBuffer.length = 17 


Result of findAndcopyValueO is 
17 




12 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




13 


InltDlsDiavTextO 

dcs = 4 

buffer = 00 01 ... OF 








Successful call (with tag SDh) 

tag = SDh 

dstBuffer.length = 17 
dstOffset = 


Result of findAndcopyValueO is 
17 




14 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


15 


Append tag OFh 

buffer = 00 01 ... OF 








Successful call (with tag SFh) 

tag = SFh 

dstBuff er . length = 16 
dstOffset = 


Result of findAndcopyValueO is 
16 




16 


Compare buffer 

buffer = 00 01 ... OF 


Result is OOh 





6.2.7.14.4 Test Coverage 



CRR number 


Test case number 


N1 


8, 10, 12 


N2 


6 


N3 


7, 9, 11 


N4 


13, 14, 15, 16 


PI 


1 


P2 


2, 3, 4, 5 


CI 


Does not apply for Proactive Handler 



6.2.7.15 Method findAndCopyValue(byte tag, byte occurence, short valueOffset, byte[] 
dstBuffer, short dstOffset, short dstLength) 

Test Area Reference API_2_PAH_FACYBBS_BSS. 
6.2.7.15.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short f indAndCopyValue (byte tag, 

byte occurence, 
short valueOffset, 
byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws java . lang . NullPointerException, 

java . lang . ArraylndexOutOf BoundsException, 
ToolkitException 

6.2.7.15.1.1 Normal execution 

• CRRNl: looks for the indicated occurrence of a TLV element from the beginning of a TLV hst and copy its 
value into a destination buffer. 

• CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + dstLength is 
returned. 

• CRRN4: The search method is comprehension required flag independent. 

6.2.7.15.1.2 Parameter errors 

• CRR? 1 : if dstBuffer is nuU NullPointerException shaU be thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shaU be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 
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6.2.7.15.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 



6.2.7.15.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.7.15.3 



Test Suite files 

API_2_PAH_FACYBBS_BSS_1 .scr 
API_2_PAH_FACYBBS_BSS_1 .Java 
API_2_PAH_FACYBBS_BSS_1 .Idr 
API_2_PAH_FACYBBS_BSS_1 .clr 
API_2_PAH_FACYBBS_BSS_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


initialize the handler 








findAndCopyVaiueQ with a nuii dstBuffer 


NullPointerException is thrown 




2 


initDispiayTextO with length = 15 








d^tOff^pt ^ d^tBuffpr Ipnath 

tag = ODh, occurrence = 1 
valueOffset = 
dstBuff er . length = 5 
dstOffset = 6 
dstLength = 


ArraulnrlPvOi itOf Rm inrlQFvr'Pntin 

r\\ 1 Cty II lUCAWU LWI EJUUI lUo^AUCjJLIU 

n Is thrown 




3 


dstOffset < 

dstBuff er . length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n Is thrown 




4 


d^tLpnath ^dstBuffpr ienath 

UOlkdiUtii .^U^&UU i Id aid iU &i i 

dstBuff er . length = 5 
dstOffset = 
dstLength = 6 


ArravlnrlpyOi itOf Rni inHQFyppntin 

n Is thrown 




5 


dstOffset + dstLength >dstBuffer.length 

dstBuff er . length = 5 

dstOffset - 3 
dsu^engun J 


ArraylndexOutOfBoundsExceptio 

n ic thrn\A/n 

1 1 1o 11 11 UWI 1 




6 


dstLength < 

dstBuffer . length = 5 

dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


InitDispiayTextO with length = 5 








valueOffset > Text String Length 

tag = ODh, occurrence = 1 
valueOffset = 7 
dstBuff er . length = 15 
dstOffset = 
dstLength = 


ToolkitException. OUT OF TLV 
BOUNDARIES Is thrown 




8 


valueOffset < 

valueOffset = -1 
dstBuffer . length = 15 
dstOffset = 
dstLength = 1 


ToolkltExceptlon.OUT OF TLV 
BOUNDARIES Is thrown 




9 


dstLength > Text String length 

valueOffset = 
dstBuff er . length = 15 
dstOffset = 

dstLength = 7 


ToolkitException. OUT OF TLV 
BOUNDARIES Is thrown 




10 


valueOffset + dstLength > Text String length 

valueOffset = 2 
dstBuff er . length = 15 
dstOffset = 
dstLength = 5 


ToolkltExceptlon.OUT OF TLV 
BOUNDARIES Is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


11 


InitDispiayTextQ 








Select a TLV (tag 02h) 








findAndCopyValueO 

tag = ODh 
occurrence = 2 


ToolkitException . UNAVAI LABLE 
ELEMENT is thrown 






Call the getValueLengthO method 


ToolkitException . UNAVAI LABLE 
ELEMENT is thrown. 




12 


initDisplayTextO 

dcs — 4 

buffer = 00 01 ... OF 








Successful call 

UClvj — \J U 11 f L^L^L^m_L_LCI^ilL^C^ — J_ 

valueOffset = 
dstBuffer . length = 17 
dstOffset = 
dstLength = 17 


Result of findAndCopyValueO is 

1 / 




13 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 




-1 A 


inillallZc USIDUTIcl 

dstBuffer = 55 55 ... 55 








Successful call 

tag = ODh, occurrence = 1 
valueOffset = 2 
dstBuffer . length = 20 
asLCjirset — 6 
dstLength = 12 


Result of findAndCopyValueO is 
15 




15 


Compare buffer 

buffer = 

cc etc: cc: r\ '\ r\ ^ 

00 00 00 01 02 

03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 


Result is OOh 




16 


Append a Text String TLV 

tag = OD 

buffer = UU 11 22 Jj 44 00 (no specific 
DCS byte) 









Successful call 

uoy — \jLJiif vj 1,^ 1,^ u J- J- 1; 1 1 1.-. t; — -l 

valueOffset = 
dstBuffer. length = 17 
dstOffset = 
dstLength = 17 


Result of findAndCopyValueO is 

1 / 




17 


Compare buffer 

hm-F-Fcir = 04 00 01 OF 


Result is OOh 




18 


Successful call 

UCiy — \J LJ Ll f *^k^L-LJ-L-L^ilL-^ — ^ 

valueOffset = 
dstBuff er . length = 6 
dstOffset = 
dstLength = 6 


Result of findAndCopyValueO is 6 




19 


Compare buffer 

buffer = 00 11 22 33 44 55 


Result is OOh 




20 


InitDisplayTextO 

dcs = 4 

Durrer — UU Ul ... Ut 








Successful call (with tag SDh) 

tag = 8Dh 
occurrence = 1 
valueOffset = 
dstBuffer . length = 17 
dstOffset = 
dstLength = 17 


Result of findAndCopyValueO is 
17 




21 


Compare buffer 

buffer = 04 00 01 ... OF 


Result is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


22 


Append tag OFh 

Duiier = UU Ul ... UF 








Successful call (with tag 8Fh) 

tag = 8Fh 
occurrence = 1 
valueOffset = 
dstBuff er . length = 16 
dstOffset = 
dstLength = 16 


Result of findAndcopyValueO is 
16 




23 


Compare buffer 

buffer = 00 01 ... OF 


Result is OOh 





6.2.7.15.4 Test Coverage 



CRR number 


Test case number 


N1 


13, 15, 17, 19 


N2 


11 


N3 


12, 14, 16, 18 


N4 


20, 21 , 22, 23 


PI 


1 


P2 


2, 3, 4, 5, 6 


P3 


7, 8, 9, 10 


CI 


Does not apply for ProactiveHandler 



6.2.7.16 Method findAndCompareValue(byte tag, byte[] compareBuffer, short 
compareOffset) 

Test Area Reference API_2_PAH_FACRB_BS. 
6.2.7.16.1 Conformance requirement 

The method with following header shall be compliant to its deiinition in the API. 

public byte f indAndCompareValue (byte tag, 

byte[] compareBuffer, 
short compareOffset) 
throws java . lang . NullPointerException, 

java . lang . ArraylndexOutOf BoundsException, 
ToolkitException 

6.2.7.16.1.1 Normal execution 

Looks for the first occurrence of a TLV element from beginning of a TLV list and compare its value with a buffer: 

• CRRNl : if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN2: if the method is successful then the corresponding TLV becomes current. 

• CRRN3 : if identical returns 0. 

• CRRN4: if the first miscomparing byte in simple TLV is less than that in compareBuffer returns -1. 

• CRRN5: if the first miscomparing byte in simple TLV is greater than that in compareBuffer returns 1. 

• CRRN6: The search method is comprehension required flag independent. 

6.2.7.16.1.2 Parameter errors 

• CRRPl: if compareBuffer is null NullPointerException shall be thrown. 
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• CRRP2: if compareOffset would cause access outside array boimds ArraylndexOutOfBoundsException shall be 
thrown. 



6.2.7.16.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitExceptionHANDLER_NOT_AVAILABLE. 



6.2.7.16.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.7.16.3 



Test Suite files 

AP1_2_PAH_FACRB_B S_l . scr 
AP1_2_PAH_FACRB_BS_1 .Java 
API_2_PAH_FACRB_BS_1 .Idr 
API_2_PAH_FACRB_BS_1 .ch 
API_2_PAH_FACRB_BS_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


initialize the handler 








findAndCompareValueO with a null dstBuffer 


NullPointerException is thrown 




2 


initDisplayTextO with length = 15 








compareOffset > compareBuffer.length 

tag = ODh 

compareBuffer.length = 20 
compareOffset = 21 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

compareBuffer.length = 20 
compareOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > compareBuffer.length 

compareBuffer.length = 15 
compareOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + length > 

compareBuf fer . length 
compareBuffer.length = 20 
compareOffset = 5 


Array 1 ndexOutOfBoundsExceptio 
n is thrown 




6 


InitDisplayTextO 








Select a TLV (tag 02h) 








findAndCompareValueO 

tag = 03h 


Tooll<itException . UNAVAI LABLE 
ELEIVIENT is thrown 






Call the getValueLengthO method 


ToolkitException. UNAVAILABLE_ 
ELEMENT is thrown. 




7 


InitDisplayTextO 

dcs = 4 

buffer = 00 01 ... OF 














Initialize compareBuffer 

compareBuf fer = 
04 00 01 ... OF 








Compare buffers 

tag = ODh 
compareOffset = 


Result is OOh 




8 


Verify current TLV 

getValueLength ( ) 


Result is 17 




9 


Initialize compareBuffer 

compareBuffer = 
04 00 01 ... 10 








Compare buffers with same parameters 


Result is -1 
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Id 


Description 


API Expectation 


APDU Expectation 


10 


Initialize compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Comnare buffers with same Darameters 

III I^Cll ^/U 1 l^^l w TV 1 & I 1 wdl 1 1 w 1^01 Cll 1 l^^lwl w 


Ppci lit ic -lI 




11 


Initialize compareBuffer 

conipsiTsBuf f SIT = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 








Compare buffers 

compareOf f set = 2 


Result is OOh 




12 


append a Text String TLV 

tag — uun 

buffer = 00 11 22 33 44 55 








Initialize compareBuffer 

m r~i T" t:^ R 1 1 "F "F r~ : 

55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 









Compare buffers 

i^i^TTTr^;^ T*"oO "F "F Q = 


Result Is OOh 




13 


Initialize compareBuffer 

L.. 1 L L kJ Cl-LvI^lJUL_L_LCI^_L — 

55 55 04 01 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 









Compare buffers 

i^i^mT^;^ T*"oO "F "F Q = 


Result is -1 




14 


Initialize compareBuffer 

i^i^mT^a T~oRn "F "Fo T~ = 

55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OD 10 55 









Compare buffers 

compareOf f set = 2 


Result is +1 




15 


InltDlspiayTextO 

dcs = 4 

buffer = 00 01 ... OF 









Initialize compareBuffer 

CompareBuffer = 04 00 01 ... OF 








Successful call (with tag 8Dh) 

tag = 8Dh 

cO'mpareB^iff er . length - 17 
comp^ireOf f set 


Result is OOh 




16 


Append tag OFh 

buffer = 00 01 ... OF 








Initialize compareBuffer 

compareBuffer = 00 01 ... OF 








Successful call (with tag 8Fh) 

tag = 8Fh 

compareBuf fer . length = 16 
compareOf f set = 


Result is OOh 




17 


Initialize compareBuffer 

compareBuffer = 00 99 01 03 ... OF 








Successful call (with tag 8Fh) 

tag = 8Fh 

compareBuf fer . length = 16 
compareOf f set = 


Result is +1 
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HRR niiinhpr 


Tp^t PfiQP niiiYihpr 

1 cot ^aoc iiuiiiud 


N1 


\j 


N2 


8 


N3 


7, 11, 12, 17 


N4 


9, 13 


N5 


10, 14 


N6 


15, 16 


P1 


1 


P2 


2, 3, 4, 5 


C1 


Does not apply for Proactive Handler 



6.2.7.17 Method findAndCompareValue(byte tag, byte occurence, short valueOffset, 
byte[] compareBuffer, short compareOffset, short compareLength) 

Test Area Reference API_2_PAH_FACRBBS_BSS. 
6.2.7.17.1 Conformance requirement 

The method with following header shall be compliant to its definition in the APT 

public byte f indAndCompareValue (byte tag, 

byte occurence, 
short valueOffset, 
byte [ ] compareBuffer, 
short compareOffset, 
short compareLength) 
throws java . lang .NullPointerException, 

java . lang .Array IndexOutOfBoundsExcept ion, 
ToolkitException 

6.2.7.17.1.1 Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of a TLV hst and compare its value with a 
buffer: 

• CRRN 1 : if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN2: if the method is successful then the corresponding TLV becomes current. 

• CRRN3: if identical is returned. 

• CRRN4: if the first miscomparing byte in simple TLV is less than that in compareBuffer -1 is returned. 

• CRRN5: if the first miscomparing byte in simple TLV is greater than that in compareBuffer 1 is returned 

• CRRN6: The search method is comprehension required flag independent. 

6.2.7.17.1 .2 Parameter errors 

• CRRPl : if compareBuffer is null NullPointerException shall be thrown. 

• CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if 
compareLength is negative ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: if valueOffset, compareLength or both are out of the current TLV an instance of ToolkitException shall 
be thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

• CRRP4: if an input parameter is not valid (e.g. occurence = 0) an instance of ToolkitException shall be thrown. 
The reason code shall be ToolkitException BAD_INPUT_PARAMETER. 
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6.2.7.17.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 



6.2.7.17.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.7.17.3 



Test Suite files 

API_2_PAH_FACRBBS_BSS_1 .scr 
API_2_PAH_FACRBBS_BSS_1 .Java 
API_2_PAH_FACRBBS_BSS_1 .Idr 
API_2_PAH_FACRBBS_BSS_1 .clr 
API_2_PAH_FACRBBS_BSS_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


initialize the handler 








findAndCompareValueO with a null 
compareBuffer 


NullPointerException is thrown 




2 


InitDispiayTextO with length = 15 








compareOffset > compareBuffer.iength 

valueOffset = 
compareBuffer.iength = 5 
compareOffset = 6 
compareLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




ri 
o 


pnmnfii'pOffQPt 

compareBuffer . length = 5 
compareOffset = -1 
compareLength = 1 


m 1 ciy II ILIC7AX.^ULWI EJLfUl ILIOI^AOC|JlltJ 

n is thrown 




4 


compareLength >compareBuffer.length 

coinpareBuff er . length = 5 
compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 

1 1 lO 11 II UWI 1 




5 


compareOffset + compareLength 

>compareBuf f er . length 
compareBuffer.iength = 5 

compareOffset = 3 
compareLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


compareLength < 

compareBuffer.iength = 5 
compareOffset = 
compareLength = -1 


Array 1 ndexOutOfBoundsExceptio 
n is thrown 




7 


InitDispiayTextO with length = 5 








valueOffset > Text String Length 

tag = ODh, occurrence = 1 
valueOffset = 7 
compareBuffer.iength = 15 
compareOffset = 
compareLength = 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
compareBuffer.iength = 15 

compareOffset = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


compareLength > Text String length 

valueOffset = 
compareBuffer.iength = 15 
compareOffset = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


10 


valueOffset + compareLength > Text String 
length 

valueOffset = 2 
compareBuf fer . length = 15 
compareOf f set = 
compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Invalid parameter 

occurrence = 


ToolkitException.BAD_INPUT_PA 

RAMETER is thrown 




12 


InitDisplayTextO 








Select a TLV (tag 02h) 








findAndCompareValueO 

tag = ODh 
occurrence = 2 


ToolkitException.UNAVAILABLE_ 
ELEMENT is thrown 






Call the getValueLengthO method 


ToolkitException.UNAVAILABLE_ 
ELEIVIENT is thrown. 




13 


InitDisplayTextO 

dcs = 4 

buffer = 00 01 ... OF 








Initialize compareBuffer 

c omp 3 2rsBu f f s 3r — 
04 00 01 ... OF 








findAndCompareValueO 

tag = ODh, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 17 


Result is OOh 




14 


Verify current TLV 

getValueLength ( ) 


Result is 17 




15 


Initialize compareBuffer 

compareBuffer = 
04 00 01 ... 10 








Compare buffers with same parameters 


Result is -1 




16 


initialize compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Comnarp buffers with samp narameters 

III l^dl 1 1^71 w VV 1 CI 1 wUI 1 1 V I^QI dl 1 l^^ft wl V 


ppci lit -1-1 




17 


Initialize compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 ns 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers 

valueOffset = 2 
compareOf f set = 3 

f~'i^inT^;3 T-oT .on rT"l" Vi = 1 '9 


Result is OOh 




1 8 


Initialize coirmareRiiffer 

1 1 1 1 cioi i^^f w^^i 1 ii^ni ^^L^^A 1 1^71 

compareBuffer = 
55 55 55 02 01 
03 04 05 06 07 

08 09 OA OB OC 

55 55 55 55 55 








Comnarp buffpr^ with ^amp naramptprs 

^^^/ 1 1 1 1 V 1 1 V 1 w V V 1 11 1 1 1 1 V 1 Ql 1 Iwl w 


Ppci lit IQ -1 




19 


Initialize compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OA OD 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 
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Id 


Description 


API Expectation 


APDU Expectation 


20 


append a Text String TLV 

tag = ODh 

buffer = 00 11 22 33 44 55 








Initialize compareBuffer 

L. UlLLUcL J- CD Lt J_ J_ C J- — 

04 00 01 ... OF 









findAndCompareValueQ 

UClvj — \J U 11 f L^L^L^m_Li_dlk^C — _L 

valueOffset = 
compareOf f set = 
compareLength = 17 


Result is OOh 




21 


Initialize compareBuffer 

00 11 22 33 44 55 









findAndCompareValueQ 

valueOffset = 
compareOf f set = 
compareLength = 6 


Result is OOh 




22 


Initialize compareBuffer 

1 L L kJ Cl-LC^lJUL_L_LC^_L — 

00 11 22 33 44 66 









findAndCompareValueQ 

uoy — KJULif vj o o u J- J- 1; 1 1 o t; — ^ 

valueOffset = 
compareOf f set = 
compareLength = 6 


Result is -1 




23 


InitDisplayTextQ 

dcs = 4 

buffer = 00 01 ... OF 








iniiiaiize coinparcDUTTer 

CompareBuffer = 04 00 01 ... OF 








ouccessTui call ^wiin lag oun^ 

tag = 8Dh, occurrence = 1 
valueOffset = 
compareBuff er . length = 17 
compareOf f set = 
compareLength = 17 


riesuii IS uun 




24 


Append tag OFh 

buffer = 00 01 ... OF 








iniiiaiize CQinparsDijTTer 

compareBuffer = 00 01 ... OF 








ouccessTui can ^wiin lag orn^ 

tag = 8Fh, occurrence = 1 
valueOffset = 
compareBuff er . length = 16 
compareOf f set = 
compareLength = 16 


riesuii IS uun 




25 


Initialize compareBuffer 

compareBuffer =0099 02 ... OF 








findAndCompareValueQ 

tag = ODh, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 17 


Result is +1 
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6.2.7.17.4 Test Coverage 



HRR niiinhpr 


Tp^t PflQP niiiYihpr 

1 cot ^aoc iiuiiiud 


N1 

IM 1 


1 ^ 




14 
1 1 


NT 

1 NO 


n 17 ?n 91 


N4 


15, 18, 22 


N5 


16, 19 


N6 


23, 24 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7, 8, 9, 10 


P4 


11 


C1 


Does not apply for Proactive Handler 



6.2.7.18 Method appendArray 

Test Area Reference: API_2_PAH_APDA_BSS. 

6.2.7.18.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

void appendArray (byte [ ] buffer, 
short offset, 
short length) 
throws java . lang . NullPointerExcept ion, 

java . lang .Array IndexOutOfBoundsExcept ion, 
ToolkitException 

6.2.7.18.1.1 Normal execution 

• CRRNl : appends a buffer into the Edithandler buffer. 

• CRRN2: a successful append does not modify the TLV selected. 

6.2.7.18.1.2 Parameters error 

• CRRPl; if buffer is null, a java.lang.NuUPointerException is thrown. 

• CRRP2: if offset or length or both would cause access outside the array bounds, or if length is negative, a 
java.lang.ArraylndexOutOfBoundsException is thrown. 

6.2.7.18.1 .3 Context errors 

• CRRCl : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 

6.2.7.18.2 Test suite files 

Test Script: API_2_PAH_APDA_BSS_l.scr 

Test Applet: API_2_PAH_APDA_BSS_1 .java 

Load Script: API_2_PAH_APDA_BSS_l.ldr 

Cleanup Script: APl_2_PAH_APDA_BSS_l.ch 

Parameter File: API_2_PAH_APDA_BSS_l.par 
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6.2.7.18.3 Test procedure 



Id 


DescriDtion 


API ExDectation 


APDU ExDectation 


1 


Null buffer 


NullPointerException is thrown 




2 


offset > buffer.length 

buf fer . length = 5 
offset = 6 
length = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


offset < 

buffer.length = 5 
offset = -1 
length = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > buffer.length 

buffer.length = 5 

offset = 

length = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


offset + length > buffer.length 

buffer.length = 5 
offset = 3 
length = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


lenoth < 

buffer.length = 5 
offset = 
length = -1 


Arravlnrif^xOiitOf Rniinri'^Fxrpntin 
n is thrown 




7 


Handler overflow 

buffer.length = 256 
offset = 
length = 256 


ToolkltExceotion HANDLER OVE 
RFLOW is thrown 




8 


Initialize handler 








Select Command Details TLV 








Successful call 








buffer = FF FE ... F8 








offset = 








length = 8 








Verify Current TLV: Call getValueLengthQ 


Result is 03h 




9 


Clear the handler 








Successful call 








buffer = FF FE ... F8 








offset = 








length = 8 








Call copyO method 









Compare the arrays 

compareBuf f er = FF FE ... F8 


Result of 

javacard.f ramework. Uti 1 . arrayCom 
pare() is OOh 




10 


Successful call 

buffer = 00 01 ... 07 

offset = 2 
length = 6 








Call copyO method 








Compare the arrays 

compareBuf fer = FF FE ... F8 02 03 ... 07 


Result of 

javacard .f ram e work. Uti 1 .arrayCom 
pare() is OOh 




11 


Successful call 

buffer = 11 22 ... 88 
offset = 2 
length = 4 








Call copyO method 








Compare the arrays 

compareBuf fer = FF FE ... F8 02 03 ... 07 33 
44 55 66 


Result of 

javacard.framework.Util. arrayCom 
pare() is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


12 


Clear the handler 








Successful call 

buffer = 00 01 ... FC 
offset = 
length = 253 








Call getLengthO method 


result = 253 






Call copyO method 








Compare handler 

compareBuf fer = 00 01 ... FC 


Result of 

javacard.framework.Utll.arrayCom 
pare() is OOh 





6.2.7.18.4 Test Coverage 



CRR number 


Test case number 


N1 


9, 10, 11, 12 


N2 


8 


P1 


1 


P2 


2, 3, 4, 5, 6 


C1 


7 


C2 


Does not apply for ProactiveHandler 



6.2.7.19 Method appendTLV(byte tag, byte value) 

Test Area Reference: API_2_PAH_APTLBB. 

6.2.7.19.1 Conformance requirement: 

The method with following header shall be compliant to its deiinition in the API. 

void appendTLV (byte tag, byte value) 
throws ToolkitException 

6.2.7.19.1.1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV Ust (1-byte element). 

• CRRN2: A successful append does not modify the TLV selected. 

6.2.7.19.1.2 Parameters error 

No requirements. 

6.2.7.19.1.3 Context errors 

• CRRCl: if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 

6.2.7.19.2 Test suite files 

Test Script: API_2_PAH_APTLBB_l.scr 
Test Applet: API_2_PAH_APTLBB_l.java 
Load Script: API_2_PAH_APTLBB_Lldr 
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Cleanup Script: API_2_PAH_APTLBB_l.clr 
Parameter File: API_2_PAH_APTLBB_l.par 



6.2.7.19.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


•| 


Call annendArravn 

length = 251 








Handler Overflow: Call the appendTLV() 
method 


ToolkitException.HANDLER_OVE 
RFLOW is thrown 




2 


Initialize handler 








Select Command Details TLV 








uaii ine appena i i-V\) meinou 








veriiy uurreni ilv. uaii g^ivaiueLengin^j 


rieSUIt IS UoM 




3 


Clear the handler 








Successful call 

tag = 84h 
value = OOh 








Call copyO method 








Compare the arrays 

compareBuf f er = 84 01 00 


Result of 

javacard .framework. Uti 1 . arrayCo m 
pare() is OOh 




4 


Successful call 

tag = Olh 
value = FEh 








Call copyO method 









Compare the arrays 

compareBuf fer = 84 01 00 01 01 FE 


Result of 

javacard.f ramework. Uti 1 .arrayCo m 
pareO is OOh 




5 


Clear the handler 








Call appendArrayO 

length = 250 

buffer = 00 81 F7 03 04 ... F9 








Successful call 

tag = 84h 
value = OOh 








Call getLengthO method 


result = 253 






Call copyO method 








Compare the array 

compareBuf fer = 00 81 F7 03 04 ... F9 84 01 

00 


Result of 

javacard .f ram e work. Uti 1 .arrayCom 
pare() is OOh 





6.2.7.19.4 Test Coverage 



CRR number 


Test case number 


N1 


3, 4, 5 


N2 


2 


01 


1 


02 


Does not apply for Proactive Handler 



6.2.7.20 Method appendTLV(byte tag, byte valuel , byte value2) 

Test Area Reference: API_2_PAH_APTLBBB. 
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6.2.7.20.1 Conformance requirements 

The method with following header shaU be compliant to its definition in the API. 

void appendTLV (byte tag, 

byte value) 
throws ToolkitException 

6.2.7.20.1.1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV hst (2-byte element). 

• CRRN2: A successful append does not modify the TLV selected. 

6.2.7.20. 1 .2 Parameters error 

No requirements 

6.2.7.20. 1 .3 Context errors 

• CRRCl : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER NOT AVAILABLE. 



6.2.7.20.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.7.20.3 



Test suite files 

API_2_PAH_APTLBBB_I .scr 
API_2_PAH_APTLBBB_I .Java 
API_2_PAH_APTLBBB_1 .Idr 
API_2_PAH_APTLBBB_1 .ch 
API_2_PAH_APTLBBB_I .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Call the InitDlspiayTextO 

length = 250 








Handler Overflow: Call the appendTLVQ 
method 


ToolkitException. HANDLER_OVE 
RFLOW is thrown 




2 


Initialize handler 








Select Command Details TLV 








Call the appendTLVO method 








Verify Current TLV: Call getValueLength() 


Result is 03h 




3 


Clear the handler 








Successful call 

tag = 84h 
valuel = OOh 
value2 = Olh 








Call copvO method 








Compare the arrays 

compareBuf fer = 84 02 00 01 


Result of 

javacard.framework.Utll.arrayCom 
pare() is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


4 


Successful call 

tag = Olh 
valuel = FEh 
value2 = FDh 








Call copyO method 








Compare the arrays 

compareBuf fer = 84 02 00 01 01 02 FE FD 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOti 




5 


Clear the handler 








Call appendArrayO 

length =24 9 

buffer = 00 81 F6 03 04 ... F8 






■-- - 


Successful call 

tag = 84h 
valuel = OOh 
value2 = Olh 








Call getLengthO method 


result = 253 






Call copyO method 








Compare handler 

compareBuf fer = 00 81 F6 03 04 ... F8 84 02 
01 


Result of 

javacard. framework. Util.arrayCom 
pare() is OOh 





6.2.7.20.4 Test Coverage 



CRR number 


Test case number 


N1 


3, 4,5 


N2 


2 


01 


1 


02 


Does not apply for Proactive Handler 



6.2.7.21 Method appendTLV(byte tag, byte[ ] value, short valueoffset, short 
valuelength) 

Test Area Reference: API_2_PAH_APTLB_BSS. 
6.2.7.21.1 Conformance requirement 

The metfiod with following header shall be compliant to its definition in the APT 

void appendTLV (byte tag, 

byte [ ] value, 
short valueoffset, 
short valuelength) 
throws java . lang .NullPointerException, 

java . lang .Array IndexOutOfBoundsExcept ion, 
ToolkitException 

6.2.7.21.1.1 Normal execution 

• CRRNl : Appends a TLV element to the current TLV list (byte-array element). 

• CRRN2: A successful append does not modify the TLV selected. 

6.2.7.21.1.2 Parameters error 

• CRRPl : if value is nuU, a java.lang.NullPointerException is thrown. 

• CRRP2: if valueoffset or valuelength or both would cause access outside the array bounds, or if length is 
negative, a java.lang.ArraylndexOutOfBoimdsException is thrown. 
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6.2.7.21.1.3 Context errors 

• CRRCl : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_N0T_AVA1LABLE. 

• CRRC3: if valuelength is greater than 255, a ToolkitException is thrown with reason code 
BAD INPUT PARAMETER. 



6.2.7.21.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.7.21.3 



Test suite files 

API_2_PAH_APTLB_BSS_l.scr 
API_2_PAH_APTLB_BSS_l.java 
API_2_PAH_APTLB_BSS_1 .Idr 
API_2_PAH_APTLB_BSS_1 .clr 
AP1_2_PAH_APTLB_BSS_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Null value 


NullPointerException is thrown 




2 


valueOffset > value.length 

value. length = 5 
valueOffset = 6 
valueLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


valueOffset < 

value.length = 5 
valueOffset = -1 
valueLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


valueLength > value.length 

value . length = 5 
valueOffset = 
valueLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


valueOffset + valueLength > value.length 

value.length = 5 
valueOffset = 3 
valueLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


valueLength < 

value.length = 5 
valueOffset = 
valueLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Handler overflow 

value.length = 254 
valueOffset = 
valueLength = 254 


ToolkitException. HANDLER_OVE 
RFLOW is thrown 




8 


Bad parameter 

value.length = 256 
valueOffset = 
valueLength = 256 


Tooll<itException.BAD_INPUT_PA 
RAMETER is thrown 




9 


Initialize handler 








Select Command Details TLV 








Successful call 

tag = 04 

value = FF FE ... F8 

valueOffset = 
valueLength = 8 








Verify Current TLV: Call getvaiueiength ( ) 


Result is 03h 
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Id 


Description 


API Expectation 


APDU Expectation 


10 


Clear the handler 








Successful call 

tag = 04 

value = FF FE ... F8 
valueOffset = 
valueLength = 8 









Call copyO method 








Compare the arrays 

compareBuf fer = 04 08 FF FE ... F8 


Result of 

javacard .f ram e work. Uti 1 .arrayCom 

pare() is OOh 




11 


Successful call 

tag = 85h 

value = 00 01 ... 07 
valueOffset = 2 
valueLength = 6 






- - 


Call copvO method 








Compare the arrays 

compareBuf fer = 04 08 FF FE ... F8 85 06 02 
03 ... 07 


Result of 

javacard.framework.Util. arrayCom 
pare() is OOh 




12 


Successful call 

tag = 01 

value = 11 22 ... 88 
valueOffset = 2 
valueLength = 4 








Call copyO method 









Compare the arrays 

compareBuf fer = 04 08 FF FE ... F8 85 06 02 
03 ... 07 01 04 33 44 55 66 


Result of 

javacard.framework.Util. arrayCom 
pare() is OOh 




13 


Clear the handler 








Successful call 

tag = 04 

value = 00 01 ... 7F 
valueOffset = 
valueLength = 80h 








Call copyO method 








Compare the arrays 

compareBuf fer = 04 81 80 00 01...7F 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 




14 


Clear the handler 








Successful call 

tag = 04 

value = 00 01 ... F9 
valueOffset = 

valueLength = 250 








Call getLengthO method 


result = 253 






Call copvO method 








Compare handler 

compareBuf fer = 04 81 FA 00 01...F9 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 





6.2.7.21 .4 Test Coverage 



CRR number 


Test case number 


N1 


10, 11, 12, 13, 14 


N2 


9 


PI 


1 


P2 


2, 3, 4, 5,6 


01 


7 


02 


Does not apply for Proactive Handler 


03 


8 
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6.2.7.22 Method appendTLV(byte tag, byte valuel , byte[ ] value2, short value2offset, 
short value2length) 

Test Area Reference: API_2_PAH_APTLBB_BSS. 

6.2.7.22.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

void appendTLV (byte tag, 

byte valuel 
byte [ ] value2 , 
short value2of f set , 
short value21ength) 
throws java . lang . NullPointerExcept ion, 

java . lang .Array IndexOutOfBoundsExcept ion, 
ToolkitException 

6.2.7.22.1.1 Normal execution 

• CRRNl: Appends a TLV element to the current TLV Ust (1 byte and a byte-array element). 

• CRRN2: A successful append does not modify the TLV selected. 

6.2.7.22. 1 .2 Parameters error 

• CRRPl: if value2 is null, a java.lang.NullPointerException is thrown. 

• CRRP2: if value2offset or value21ength or both would cause access outside the array bounds, or if length is 
negative, a java.lang.ArraylndexOutOfBoundsException is thrown. 

6.2.7.22. 1 .3 Context errors 

• CRRC 1 : if the EditHandler buffer is too small to append the requested data, a ToolkitException is thrown with 
reason code HANDLER_OVERFLOW. 

• CRRC2: if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAlLABLE. 

• CRRC3: if valuelength is greater than 255, a ToolkitException is thrown with reason code 
BAD_INPUT_PARAMETER. 

6.2.7.22.2 Test suite files 

Test Script: API_2_PAH_APTLBB_BSS_l.scr 

Test Applet: API_2_PAH_APTLBB_BSS_1 .java 

Load Script: API_2_PAH_APTLBB_BSS_l.ldr 

Cleanup Script: API_2_PAH_APTLBB_BSS_l.clr 

Parameter File: API_2_PAH_APTLBB_BSS_1 .par 
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6.2.7.22.3 Test procedure 



Id 


DescriDtion 


API ExDectation 


APDU ExDectation 


1 


Null value2 


NullPointerException is thrown 




2 


value20ffset > value2.length 

value2 . length = 5 
value20ffset = 6 
value2Length = 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


value20ffset < 

value2 . length = 5 
valuezOffset = -1 
value2Length = 1 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




4 


value2Length > value2.length 

value2 . length = 5 
value20ffset = 

value2Length = 6 


ArraylndexOutOfBoundsExceptio 
n is tfirown 




5 


value20ffset + value2Length > value2.length 

value2 . length = 5 
value20f f set = 3 
value2Length = 3 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




6 


value2Length < 

value2 . length = 5 
value20f f set = 
value 2 Length — ~ 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Handlar ovGrflow 

value2 . length = 254 
value20ffset = 
value2Length = 254 


ToolkltExceotion HANDLER OVE 
RFLOW is thrown 




« 

o 


value2Length = 25 6 


TnnlkitFYrpntinn RAD INPI IT PA 
riAMt 1 tn IS tnrown 




9 


Initialize handler 








Select Command Details TLV 








f^llCCPQ^flll Cflll 








tag = 04 








vaxufcrJ- — UO 








vd-LLtt:^ — rr n Hj ... no 








value20ffset = 








value2Length = 8 








Verify Current TLV: Call getValueLengthQ 


Result is 03h 




10 


Clear the handler 








Successful call 








tag = 04 








valuel = 05 








value2 = FF FE ... F8 








value20ffset = 








value2Length = 8 








Call copyO method 






■ - - 


Compare the arrays 

CompareBuf fer = 04 09 05 FF FE ... F8 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 




11 


Successful call 

Lay — ooil 

valuel = 55h 
value2 = 00 01 ... 07 
value20ffset = 2 
value2Length = 6 








Call copyO method 








Compare the arrays 

CompareBuf fer = 

04 09 05 FF FE ... F8 

85 07 55 02 03 ... 07 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


12 


Successful call 

tag = 01 
valuel = 44h 
value2 = 11 22 ... 88 
value20ffset = 2 
value2Length = 4 








Call copyO method 








Compare the arrays 

CompareBuf f er = 
04 09 05 FF FE ... F8 
85 07 55 02 03 ... 07 
01 05 44 33 44 55 66 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOh 




13 


Clear the handler 








Successful call 

tag = 04 
valuel =00 
value2 = 01 ... 7F 
value20ffset = 
value2Length = 7Fh 








Call copvO method 








Compare the arrays 

compareBuf fer = 04 81 80 00 01...7F 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOti 




1 A 


nipflr thp hflndipr 








f^llCCPQ^flli Cflii 

tag = 04 
valuel = 00 
value2 = 01 ... F9 
value20ffset = 
value2Length =24 9 








Call getLengthO method 


result = 253 






Call copyO method 








Compare handler 

compareBuf fer = 04 81 FA 00 01...F9 


Result of 

javacard.framework.Util.arrayCom 
pare() is OOfi 





6.2.7.22.4 Test Coverage 



CRR number 


Test case number 


N1 


10, 11, 12, 13, 14 


N2 


9 


PI 


1 


P2 


2, 3, 4, 5, 6 


CI 


7 


02 


Does not apply for Proactive Handler 


03 


8 



6.2.7.23 Method clear 

Test Area Reference: AP1_2_PAH_CLER. 



6.2.7.23.1 Conformance requirement 

The method with following header shall be compliant to its definition in the APT 

void clear 

throws ToolkitException EditHandler 

6.2.7.23. 1 . 1 Normal execution 

• CRRNl : Clears the TLV Ust of an EditHandler. 
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• CRRN2: Resets the current TLV selected. 

6.2.7.23. 1 .2 Parameters error 

No requirements. 

6.2.7.23. 1 .3 Context errors 

• CRRCl : if the EditHandler buffer is busy, a ToolkitException is thrown with reason code 
HANDLER_NOT_AVAILABLE. 



6.2.7.23.2 Test suite files 



Test Script: 


APT 


_2_ 


_PAH 


CLER_ 


_l.scr 


Test Applet: 


APT 


_2_ 


_PAH_ 


_CLER_ 


_l.java 


Load Script: 


APT 


.2. 


PAH. 


.CLER. 


.l.ldr 


Cleanup Script: 


APT 


.2. 


PAH. 


.CLER. 


T.ch 


Parameter File: 


APT 


.2. 


PAH. 


.CLER. 


.l.par 



6.2.7.23.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Initialize the handler 

Select Command Details TLV 
Call the getLengthO method 


Result of getLengthO is not null 






Clear the handler 

Call the getLengthQ method 


Result of getLengthO Is 




2 


Call the getValueLengthQ method 


ToolkitException . UNAVAI LABLE 
ELEMENT is thrown 





6.2.7.23.4 Test Coverage 



CRR number 


Test case number 


N1 


1 


N2 


2 


01 


Does not apply for Proactive Handler 



6.2.8 Class ProactiveResponseHandler 
6.2.8.1 Method copyAdditionallnformation 

Test Area Reference: API_2_PRH_CPAI_BSS. 
6.2.8.1.1 Conformance requirement 

The method with following header shall be compliant to its definition in the APT 

public short copyAdditionallnformation (byte [ ] dstBuffer, 

short dstOffset, 
short dstLength) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsException, 
ToolkitException 
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6.2.8.1 .1 .1 Normal execution 

• CRRNl : The copyAdditionallnformationO method shall copy a part of the additional information field from 
Result TLV element in dstBuffer, using dstOffset and dstLength. 

• CRRN2: dstBuffer shall only be modified from dstOffset to (dstOffset + dstLength - 1) (included). 

• CRRN3 : The method returns (dstOffset + dstLength) . 

• CRRN4: If a Result TLV element is available, it becomes the TLV selected after a call to the method. 

• CRRN5 : The method shall copy from the first Result TLV. 

6.2.8.1 .1 .2 Parameter errors 

• CRRPl : A NuUPointerException shall be thrown if dstBuffer is nuU. 

• CRRP2: An ArraylndexOutOfBoundsException shall be thrown if dstOffset or dstLength or both would cause 
access outside array bounds. 



6.2.8.1.1.3 



Context errors 



• CRRC 1 : A ToolkitException.UNAVAILABLE_ELEMENT shall be thrown in case of unavailable Result TLV 
element. 

• CRRC2: A ToolldtException.OUT_OF_TLV_BOUND ARIES shall be thrown if dstLenglh is greater than the 
value field of the available TLV. 



6.2.8.1.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.8.1.3 



Test Suite files 

API_2_PRH_CPAI_BSS_1 .scr 
API_2_PRH_CPAI_BSS_1 .java 
API_2_PRH_CPAI_BSS_1 .Idr 
API_2_PRH_CPAI_BSS_1 .ch 
API_2_PRH_CPAI_BSS_1 .par 

Test procedure 



id 


Description 


API Expectation 


APDU Expectation 


1 


Buiid and send a DiSPLAY TEXT command 

qualifier = 
dcs = 4 

buffer = "Text" 




DISPLAY TEXT Proactive 
command 




Terminal Response with 11 additional bytes 








Result TLV = 03 OC 01 01 23 45 67 89 AB 
CD EF 01 23 45 








NULL as parameter to dstBuffer 

dstBuffer = NULL 


NuUPointerException is thrown 




2 


dstOffset > dstBuffer.length 

dstBuffer. length = 10 
dstOffset = 11 
dstLength = 


Array 1 ndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 10 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength > dstBuffer.length 

dstBuffer.length = 10 
dstOffset = 
dstLength = 11 


ArraylndexOutOfBoundsExceptio 
n is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


o 


Hctr^ffcat J- HctI Atmth ^ HctRiiffai* lannth 

Uoiwiioci + uoiLciiyiii > uoiDuiici.iciiyiii 

dstBuffer . length = 10 
dstOffset = 6 
dstLength = 5 


Ml idyll lUcXVJULL^I DUUf lUbCXOcpilU 

n is thrown 




6 


dstLength < 

dstBuffer . length = 10 
dstOffset = 6 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Resnonse with 5 additional bvtes 








Result TLV = 03 06 01 01 23 45 67 89 








Successful call, dstBuffer is the whole buffer 

dstBuff er . length = 5 
dstOffset = 
dstLength = 5 


result of 

copyAdditionallnformationO is 
05h. 




8 


Compare dstBuffer using arrayCompare() 

src = {01, 23, 45, 67, 89} 

srcOffset = 00 
dest = dstBuffer 
destOffset = 
length = 5 


result of arrayCompareO is OOh. 




9 


Call the getValueLengthO method 


Result is 06h. 




10 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 6 additional bytes 








Result TLV = 03 07 01 AB CD EF FE DC BA 






- 


Successful call, dstBuffer is part of a buffer 

dstBuff er . length = 7 
dstOffset = 2 
dstLength = 5 


result of 

copyAdditionallnformationO is 
0711. 




11 


Compare dstBuffer using arrayCompare() 

src = (AB, CD, EF, FE, DC} 
srcOffset = 00 
dest = dstBuffer 
destOffset = 2 

length = 5 


result of arrayCompareO is OOh. 




12 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




1 erininai nesponse wiin t auuiiionai oyies 








Result TLV = 03 08 01 FE DC BA 98 76 54 

32 








Successful call, dstBuffer is part of a buffer 

dstBuffer . length = 7 

dstOffset - 
dsu^&ngun o 


result of 

copyAdditionallnformationO is 

05h. 




13 


Compare dstBuffer using arrayCompare() 

src = {FE, DC, BA, 98, 76} 
srcOffset = 00 
dest = dstBuffer 
destOffset = 

length ^ 5 


result of arrayCompareO is OOh. 




14 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




TptTYiinfil RAQnniKA with R fiHHitinnfil hvtPQ 
iciiiiiiicii ncouui IOC Willi o ciuuiiiviicii uyico 








Result TLV = 03 09 01 00 11 22 33 44 55 
66 77 








Successful call, dstBuffer is the whole buffer 

dstBuffer. length = 9 
dstOffset = 2 
dstLength = 5 


result of 

copyAdditionallnformationO is 
07h. 
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lu 


u6Scripiion 


Ari txpeciaiion 


Aruu cxpeciaiion 


15 


Compare dstBuffer using arrayCompareQ 

src = {00, 11, 22, 33, 44} 

srcOffset = 00 
dest = dstBuffer 
destOffset = 2 
length = 5 


result of arrayCompareO is OOh. 




16 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with F2h additional bytes 








Result TLV = 03 81 F3 01 00 01 02 03... 








Successful call to the method 

dstBuffer . length = F2h 

dstOffset = 
astJ-iengtri — h zn 


result of 

copyAdditionallnformationO is 
F2h. 




17 


Compare dstBuffer using arrayCompare() 

src = {00, 01, 02, 03, 04...} 

srcOffset = 00 
dest = dstBuffer 
destOffset = 
length = F2h 


result of arrayCompareO is OOh. 




18 


Call the getValueLengthQ method 


Result is F3h. 




19 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Resnonse with 5 additional bvtes 








Result TLV = 03 06 01 00 11 22 33 44 








dstLength > data available 

dstBuff er . length = 6 
dstOffset = 
dstLength = 6 


OUTOFTLVBOUNDARIES 
ToolkitException is thrown 




20 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 5 additional bytes 








Result TLV = 03 06 01 00 11 22 33 44 








Initialize dstBuffer 

dstBuffer = {OOh, Olh, 02h, 03h...} 








Call the copyAdditionallnformationO method 

dstBuffer. length = 20 
dstOffset = 5 
dstLength = 5 






- 


Compare dstBuffer using arrayCompare() 

src = { 


result of arrayCompareO is OOh 






OOh, Olh, 02h, 03h, 04h, 
OOh, llh, 22h, 33h, 44h, 
OAh, OBh, OCh, ODh, OEh, 
OFh, lOh, llh, 12h, 13h} 
srcOffset = 
dest = dstBuffer 
destOffset = 
length = 20 






21 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 2 Result TLV 








1st Result TLV = 03 06 01 01 23 45 67 89 
2nd Result TLV = 03 01 00 








Successful call to copyAdditionallnformationO 

dstBuff er . length = 5 
dstOffset = 
dstLength = 5 


result of 

copyAdditionallnformationO is 
05h. 
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lu 


u6Scripiion 


Ari txpeciaiion 


Aruu cxpeciaiion 


22 


Compare dstBuffer using arrayCompareQ 

src = {01, 23, 45, 67, 89} 

srcOffset = 00 
dest = dstBuffer 
destOffset = 
length = 5 


result of arrayCompareO is OOh. 




23 


Call the getVaiueLengthQ method 


Result is 06li. 




24 


Build and send a display text command 




DISPLAY TEXT Proactive 
command 




Terminal Response without Result Simple TLV 


Tooll<itException.UNAVAILABLE_ 
ELEIVIENT is thrown by send() 






ProactiveResponseHandler, getTheHandler 
call copyAdditionaiinformationQ 


Tooll<itException.UNAVAILABLE_ 
ELEIVIENT is thrown 





6.2.8.1 .4 Test Coverage 



CRR number 


Test case number 


N1 


8, 11, 13, 15, 17, 20, 22 


N2 


20 


N3 


7, 10, 12, 14, 16, 21 


N4 


9, 18,23 


N5 


21, 22, 23 


PI 


1 


P2 


2, 3, 4, 5, 6 


CI 


24 


C2 


19 



6.2.8.2 Method copyTextString 

Test Area Reference: API_2_PRH_CPTS_BS. 
6.2.8.2.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short copyTextString (byte [ ] dstBuffer, 

short dstOffset) 
throws java . iang . NuilPointerException, 

java . lang . Array IndexOutOfBoundsExcept ion, 
ToolkitException 

6.2.8.2. 1 . 1 Normal execution 

• CRRN 1 : The copyTextString() method copies the text string value from the first Text String TLV element, using 
dstBuffer and dstOffset. 

• CRRN2: If a Text String TLV element is available, it becomes the TLV selected. 

• CRRN3: The method returns (dstOffset + length of copied value). 

6.2.8.2.1 .2 Parameter errors 

• CRR? 1 : A NuilPointerException shall be thrown if dstBuffer is null. 

• CRRP2: A ArraylndexOutOfBoundsException shall be thrown if dstOffset or dstOffset + (length of the 
TextString to be copied, without the Data Coding Scheme included), as specified for the returned value, would 
cause access outside array bounds. 
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• CRRC 1 : A ToolkitException.UNAVAILABLE_ELEMENT shall be thrown in case of unavailable Text String 
TLV element. 



6.2.8.2.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.8.2.3 



Test Suite files 

API_2_PRH_CPTS_BS_1 .scr 
API_2_PRH_CPTS_BS_1 .Java 
API_2_PRH_CPTS_BS_1 .Idr 
API_2_PRH_CPTS_BS_1 .cb- 
API_2_PRH_CPTS_BS_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a GET INPUT command 

qualifier = OOh 
dcs = 04h 
buffer = 'Text' 
minRespLength = OOh 
maxRespLength = FFh 




GET INPUT Proactive 
command 




Terminal Response 








Text String TLV = OD 02 04 41 








ProactiveResponselHandler.getTheHandler() ; 

call the copyTextStringO method with a null 
dstBuffer 


NullPointerException Is thrown 






dstBuffer = null 
dstOffset = 






2 


Build and send a GET INPUT command 




GET INPUT Proactive 

command 

Prnflrtivp 




Terminal Response 








Text String TLV = OD 04 04 "ABC" 








Usiwiiacl + icAi iciiyiii > UolDUiici .iciiy ill 

dstBuffer. length = 04h 
dstOffset = 02h 


Miiciy iiiucxVu'uiVu'iDOuriLioCAOcpiiuii 
is thrown 




3 


dstOffset < 

dstBuffer . length = 04h 
dstOffset = -1 


ArraylndexOutOfBoundsException 
is thrown 




4 


Build and send a DISPLAY TEXT command 

qualifier = OOh 
dcs = 04h 
buffer = 'Text' 




DISPLAY TEXT 
Proactive command 




Terminal Response without Text String TLV 








ProactiveResponseHandler.getTheHandlerO ; 

call the CopyTextStringO method 


UNAVAILABLE_ELEMENT 
ToolkitException is thrown 




5 


Build and send a GET INPUT command 




GET INPUT Proactive 

command 

Proactive 




Terminal Response with a null Text String tlv 








Text String TLV = OD 00 








Initialize dstBuffer 

dstBuffer = {FOOh, FOlh, F02h, F03h} 








Call the copyTextStringO method 


Result of copyTextStringO is 02h 






dstBuff er . length = 04h 
dstOffset = 02h 
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IH 

lU 






nrtJU CApcUldllUll 


6 


Compare dstBuffer using arrayCompareQ 

src = {OFOh, OFlh, 0F2h, 0F3h} 
srcOffset = OOh 
dest = dstBuffer 
destOffset = OOh 
length = 04h 


Result of arrayCompareO is OOh 




7 


Buiid and send a GET iNPUT command 




GET INPUT Proactive 

command 

rroaciive 




Terminal Response with text length = 01 h 








Text String TLV = OD 02 04 41 








Initialize dstBuffer 

dstBuffer = {OOh, Olh, 02h, 03h} 









Call the copyTextStringO method 


Result of copyTextStringO is 01 h 






dstBuffer . length = 04h 






8 


Compare dstBuffer using arrayCompareQ 

src = {41h, Olh, 02h, 03h} 

srcOffset = OOh 
dest = dstBuffer 
destOffset = OOh 
length = 04h 


Result of arrayCompareO is OOli 




9 


Build and send a GET INPUT command 




GET INPUT Proactive 

command 
Proactive 




Terminal Response with text length = 02h 








Text String TLV = OD 03 04 42 43 








Initialize dstBuffer 

dstBuffer = {OOh, Olh, 02h, 03h} 









Call the copyTextStringO method 


Result of copyTextStringO is 04h 






dstBuffer. length = 04h 

ust-Uirset. — uzn 






10 


Compare dstBuffer using arrayCompareQ 

src = {OOh, Olh, 42h, 43h} 
srcOffset = OOh 
dest = dstBuffer 
destOffset = OOh 

length = 04h 


Result of arrayCompareO is OOh 




11 


Call the getValueLengthO method 


Result is 03h 




12 


Build and send a GET INPUT command 




GET INPUT Proactive 
cornrnanQ 




Terminal Response with text length = 7Eh 








Text String TLV = OD 7F 04 01 02 ... 7E 








Initialize dstBuffer 

dstBuffer = {OOh, OOh ... OOh} 






- 


Call the copyTextStringO method 


Result of copyTextStringO is 7Eh 






dstBuffer . length = 7Eh 
QSLurrssL — uun 






13 


Compare dstBuffer using arrayCompareQ 

src = {Olh, 7Eh} 
srcOffset = OOh 
dest = dstBuffer 
destOffset = OOh 
length = 7Eh 


Result of arrayCompareO is OOh 




14 


Call the getVaiueLengthQ method 


Result is 7Fh 
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Id 


Description 


API Expectation 


APDU Expectation 


15 


Build and send a GET INPUT command 




GET INPUT Proactive 
cornrnanQ 




Terminal Response with text length = 7Fh 








Text String TLV = OD 81 80 04 01 02 ,..7F 








Initialize dstBuffer 

dstBuffer = {OOh, Olh ... FFh} 








Call the copyTextStringO method 


Result of copyTextStringO is 8Fh 






dstBuffer . length = FFh 

dstOffset = lOh 






1 6 


Compare dstBuffer using arrayCompareQ 

src = {OOh, Olh,... OFh, 
Olh, ...7Fh, 8Fh, ... FFh} 

srcOffset = OOh 
dest = dstBuffer 
destOffset = OOh 
length = FFh 


Result of arrayCompareO is OOh 




17 


Build and send a GET INPUT command 




GET INPUT Proactive 
cornrnanQ 




Terminal Response with text length = EFh 








Text String TLV = OD 81 FO 04 01 02 ... EF 








Initialize dstBuffer 

dstBuffer = {OOh, OOh ... OOh} 









Call the copyTextStringO method 


Result of copyTextStringO is EFh 






dstBuff er . length = FFh 
(jSLUiiseL — uun 






18 


Compare dstBuffer using arrayCompareQ 

src = {Olh, ...EFh, OOh ... OOh } 

srcOffset = OOh 
dest = dstBuffer 
destOffset = OOh 
length = FFh 


Result of arrayCompareO is OOh 




19 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with two Text String TLV 








1st Text String TLV = OD 03 04 42 43 
2nd Text String TLV = OD 02 04 44 








Initialize dstBuffer 

dstBuffer = {OOh, Olh, 02h, 03h} 








Call the copyTextStringO method 


Result of copyTextStringO is 04h 






dstBuffer . length = 04h 
QSi^urrssL — uzn 






20 


Compare dstBuffer using arrayCompareQ 

src = {OOh, Olh, 42h, 43h} 
srcOffset = OOh 
dest = dstBuffer 
destOffset = OOh 
length = 04h 


Result of arrayCompareO is OOh 




21 


Call the getVaiueLengthQ method 


Result is 03h 





6.2.8.2.4 Test Coverage 



CRR number 


Test case number 


N1 


6, 8, 10, 13, 16, 18, 20 


N2 


11,14, 21 


N3 


5, 7, 9, 12, 15, 17, 19 


P1 


1 


P2 


2, 3 


C1 


4 
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6.2.8.3 Method getAdditionallnformationLength 

Test Area Reference: API_2_PRH_GTIL. 

6.2.8.3.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getAdditionalInf ormationLength ( ) 
throws ToolkitException 

6.2.8.3.1.1 Normal execution 

• CRRNl : This method returns the length of the additional information field from the first Result TLV in the 

ProactiveResponseHandler. 

• CRRN2: After a successful execution of the method, the Result TLV becomes the selected TLV of the 
ProactiveResponseHandler. 

6.2.8.3. 1 .2 Parameter errors 

No requirements. 

6.2.8.3.1.3 Context errors 

• CRRC 1 : A ToolkitException.UNAVAILABLE_ELEMENT shall be thrown in case of unavailable Result TLV 
element. 



6.2.8.3.2 Test Suite files 



Test Script: 


API. 


.2. 


PRH. 


GTIL. 


.l.scr 


Test Applet: 


API. 


.2. 


PRH. 


GTIL. 


.l.java 


Load Script: 


API. 


.2. 


PRH. 


GTIL. 


.l.ldr 


Cleanup Script: 


API. 


_2. 


_PRH 


_GTIL_ 


_l.clr 


Parameter File: 


API. 


_2. 


_PRH_ 


_GTIL_ 


_l.par 



6.2.8.3.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a DISPLAY TEXT command 

qualifier = OOh 
dcs = 04h 
buffer = 'Text' 




DISPLAY TEXT Proactive 
command 




Terminal Response without additional 
Information 








ProactlveResponseHandler.getTheHandlerO ; call 
the getAdditionallnformationLengthQ method 


Result is OOh 




2 


Call the getValueLengthO method 


Result is 01 h 




3 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT 

ProactiveProactive 

command 




Terminal Response with 1 additional byte 








Result TLV = 03 02 02 55 








ProactiveResponseHandler.getTheHandlerO ; 
call the getAddltlonallnformationLengthO 
method 


Result is 01 h 




4 


Call the getValueLengthO method 


Result is 02h 
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Id 


Description 


API Expectation 


APDU Expectation 


5 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT 

ProactiveProactive 

command 




Terminal Response with 7Eh additional bytes 

Result TLV = 03 7F 02 55 55 55 ... 








Proacti veResponseHandler.getTheHand ler() ; 
call the getAdditionallnformationLengthO 
metPiod 


Result is 7Eh 




6 


Call the getValueLengthO method 


Result is 7Fh 




7 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT 
Proactive command 




Terminal Response with 7Fh additional bytes 

Result TLV = 03 81 80 02 55 55 55 ... 








ProactiveResponseHandier.getTheHandlerQ ; 

II M-t J. A 1 I'.!.' 11 ^ M.' 1 M-t /\ 

call the getAdditionailnformationLengthQ 

method 


Result is 7Fh 




8 


Call the getValueLengthO method 


Result is 80h 




9 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT 
Proactive command 




Terminal Response with 80h additional bytes 
Result TLV = 03 81 81 02 55 55 55 ... 








ProactlveResponseHandler.getTheHandlerQ ; 
call the getAdditlonallnformationLengthO 
method 


Result is BOh 




10 


Call the getValueLengthO method 


Result is 81 h 




11 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT 
Proactive command 




Terminal Response with F2h additional bytes 

Result TLV = 03 81 F3 02 55 55 55 ... 








ProactiveResponseHandler.getTheHandlerO ; 
call the getAdditionallnformationLengthO 
method 


Result is F2h 




12 


Call the getValueLengthO method 


Result is F3h 




13 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT 
Proactive command 




Terminal Response with 2 Result TLV 

1st Result TLV = 03 03 02 01 23 
2nd Result TLV = 03 01 00 








ProactiveResponseHandler.getTheHandlerO ; 
call the getAddltlonallnformationLengthO 
method 


Result is 02h 




14 


Call the getValueLengthO method 


Result is 03h 




15 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT 
Proactive command 




Terminal Response without Result Simple TLV 


-r__ll,;i.r~,-__„4.:_„ l lhlA\/AII ADI 1 — 1 — 

ToolKltExceptlon.UNAVAILABLE_E 
LEMENT is thrown by send() 






Get ProactiveResponseHandler 








Call the getAdditionallnformationLengthO 
method 


ToolkitException.UNAVAILABLE_E 
LEMENT is thrown by 
getAdditlonallnformationLength () 
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CRR number 


Test case number 


N1 


1,3, 5, 7, 9, 11, 13 


N2 


2, 4, 6, 8,10,12,14 


C1 


15 



6.2.8.4 Method getGeneralResult 

Test Area Reference: API_2_PRH_GTGR. 
6.2.8.4.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getGeneralResult ( ) 

throws ToolkitException 

6.2.8.4. 1 . 1 Normal execution 

• CRRNl: This method returns the general result of a proactive command. 

• CRRN2: After a successful execution of the method, the Result TLV becomes the selected TLV of the 
ProactiveResponseHandler. 



6.2.8.4.1.2 

No requirements. 

6.2.8.4.1.3 



Parameter errors 



Context errors 



• CRRC 1 : A ToolkitException.UNAVAILABLE_ELEMENT shall be thrown in case of unavailable Result TLV 
element. 

• CRRC2: A ToolkitException. OUT_OF_TLV_BOUND ARIES shall be thrown if the general result byte is 
missing in the Result Simple TLV. 



6.2.8.4.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 



Test Suite files 

API_2_PRH_GTGR_1 .scr 
API_2_PRH_GTGR_1 .java 
API_2_PRH_GTGR_1 .Idr 
API_2_PRH_GTGR_1 .ch 
API_2_PRH_GTGR_1 .par 
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6.2.8.4.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a DISPLAY TEXT command 

qualifier = OOh 
dcs = 04h 
buffer = 'Text' 




DISPLAY TEXT Proactive 
command 




Terminal Response with General Result = 00 
(command performed successfully) 








ProactiveResponseHandler.getTheHandlerO 
Call the getGeneralResultO method 


Result of getGeneralResultO is OOh 




2 


Call the getValueLengthO method 


Result is 01 h 




3 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with General Result = 01, 
without Additional information on result 
(command performed with partial 
comprehension) 








ProactlveResponseHandler.getTheHandlerO 
Call the getGeneralResultO method 


Result of getGeneralResultO is 01 h 




4 


Call the getValueLengthO method 


Result is 01 h 




5 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with General Result = 01, 
with Additional information on result 

Result TLV = 03 02 01 55 (command 
performed with partial comprehension) 








ProactiveResponseHandler.getTheHandlerO 

Call the getGeneralResultO method 


Result of getGeneralResultO is 01 h 




6 


Call the getValueLengthO method 


Result is 02h 




7 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 


- - - 


Terminal Response with General Result = 02 

Result TLV = 03 04 02 65 43 21 (Missing 
information) 








ProactiveResponseHandler.getTheHandlerO 

Call the getGeneralResultO method 


Result of getGeneralResultO is 02h 




8 


Call the getValueLengthO method 


Result is 04h 




9 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 7Fh additional bytes 

Result TLV = 03 81 80 02 55 55 55 ... 








ProactlveResponseHandler.getTheHandlerO ; 
call the getGeneralResultO method 


Result is 02h 




10 


Call the getValueLengthO method 


Result is BOh 
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Id 


Description 


API Expectation 


APDU Expectation 


11 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 2 Result TLV 

1st Result TLV = 03 02 02 12 
2nd Result TLV = 03 03 03 34 56 








ProactlveResponseHandler.getTheHandlerO ; 

call the getGeneralResult ( ) method 


Result is 02h 




12 


II M-t M.^ #1 1 M-t #\ Al 1 

Call the getValueLengthQ method 


Result is 02h 




13 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response without Result Simple TLV 


ToolkitException.UNAVAILABLE_E 
LEMENT is thrown by send() 






ProactiveResponseHandler.getTheHandlerO ; 
call the getGeneralResultO method 


UNAVAILABLE_ELEIVIENT 

Tooll^itException is tlirown 




14 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response without General Result 
Byte in Result Simple TLV 


ToolkitException . UNAVAI LABLE_E 
LEMENT is thrown by send() 






ProactiveResponseHandler.getTheHandierQ ; 

call the getGeneralResultO method 
Result TLV = 03 00 


OUT_OF_TLV_BOUNDARIES 
ToolkitException is thrown 





6.2.8.4.4 Test Coverage 



CRR number 


Test case number 


N1 


1, 3, 5, 7, 9, 11 


N2 


2, 4, 6, 8, 10, 12 


CI 


13 


C2 


14 



6.2.8.5 Method getltem Identifier 

Test Area Reference: API_2_PRH_GTII. 

6.2.8.5.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getltemldentif ier ( ) 

throws ToolkitException 

6.2.8.5.1.1 Normal execution 

• CRRN 1 : The method returns the item identifier byte value from the first Item Identitier TLV element. 

• CRRN2: If an Item Identifier TLV element is available, it becomes the TLV selected. 

6.2.8.5. 1 .2 Parameter errors 

No requirements. 
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6.2.8.5. 1 .3 Context errors 

• CRRC 1 : A ToolkitException.UNAVAILABLE_ELEMENT shall be thrown in case of unavailable Item 
Identifier TLV element. 

• CRRC2: A ToolkitException.OUT_OF_TLV_BOUlSrD ARIES shall be thrown if the item identifier byte is 
missing in the Item Identifier Simple TLV. 



6.2.8.5.2 Test Suite files 



Test Script: 


API. 


.2. 


PRH. 


GTII_ 


.l.scr 


Test Applet: 


API. 


.2. 


PRH. 


GTn_ 


.l.java 


Load Script: 


API. 


_2_ 


_PRH 


_GTII_ 


_l.ldr 


Cleanup Script: 


APL 


_2_ 


_PRH_ 


_GTn_ 


_l.clr 


Parameter File: 


API. 


.2. 


PRH. 


GTII_ 


.l.par 



6.2.8.5.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Buiid and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




lerininai riesponse ^no iiein lueniiTier ilv 
available) 






Call to getitemldentifierQ with unavailable Item 
Identifier TLV 


UNAVAILABLE_ELEMENT 
ToolkitException is thrown 




2 


Build and send a SELECT ITEIUI command with 
2 items (ID=01,02) 




SELECT ITEM Proactive 
command 




Terminal Response with Item 1 selected 

Item Identifier TLV = 10 01 01 








Call the getltemldentifierO method 


Result is 01 h 




3 


Call the getValueByteQ method 

valueOffset = OOh 


Result is 01li 




4 


Build and send a SELECT ITEM command with 
3 items (ID=03, 05, 07) 




SELECT ITEM Proactive 
command 




Terminal Response with Item 5 selected 

Item Identifier TLV = 10 01 05 








Call the getitemldentifierQ method 


Result is 05h 




5 


Call the getValueByteQ method 

valueOffset = OOh 


Result is 05li 




6 


Build and send a SELECT ITEIUI command with 
3 items (ID=FDh, FEh, FFh) 




SELECT ITEM Proactive 
command 




Terminal Response with Item FFh selected 

Item Identifier TLV = 10 01 FF 








Call the getitemldentifierQ method 


Result is FFh 




7 


Call the getValueByteQ method 

valueOffset = OOh 


Result is FFh 




8 


Build and send a SELECT ITEM command with 
3 items (ID=FDh, FEh, FFh) 




SELECT ITEM Proactive 
command 




Terminal Response with 2 Item Identifier tlv 

1st Item Identifier TLV = 10 01 FFh 
2nd Item Identifier TLV = 10 01 FEh 








Call the getitemldentifierQ method 


Result is FFh 
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Id 


Description 


API Expectation 


APDU Expectation 


9 


Call the getValueByteO method 

valueOffset = OOh 


Result is FFh 




10 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response without Item identifier in 
the Item Identifier Simple TLV 

Item Identifier TLV = 10 00 








Call to getltemldentiflerO 


OUT_OF_TLV_BOUNDARIES 
ToolkitException is thrown 





6.2.8.5.4 Test Coverage 



CRR number 


Test case number 


N1 


2, 4, 6, 8 


N2 


3, 5, 7, 9 


C1 


1 


C2 


10 



6.2.8.6 Method getTextStringCodingScheme 

Test Area Reference: API_2_PRH_GTCS. 

6.2.8.6.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getTextStringCodingScheme ( ) 

throws ToolkitException 

6.2.8.6.1.1 Normal execution 

• CRRNl : This method returns the data coding scheme from the first Text String TLV element. 

• CRRN2: If a Text String TLV element is available, it becomes the TLV selected. 

6.2.8.6.1 .2 Parameter errors 
No requirements. 

6.2.8.6. 1 .3 Context errors 

• CRRCl : A ToolkitException.UNAVAILABLE_ELEMENT shall be thrown in case of unavailable Text String 
TLV element. 

• CRRC2: A ToolkitException. OUT_OF_TLV_BOUm) ARIES shall be thrown if the Text String TLV is present 
with a length of 0. 

6.2.8.6.2 Test Suite files 

Test Script: API_2_PRH_GTCS_1 .scr 

Test Applet: API_2_PRH_GTCS_l.java 

Load Script: API_2_PRH_GTCS_l.ldr 

Cleanup Script: API_2_PRH_GTCS_l.ch 

Parameter File: API_2_PRH_GTCS_1 .par 
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6.2.8.6.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 





Terminal Response (no Text String TLV 
element available) 









Call to getTextStringCodingSchemeO with 
unavailable Text String TLV 


UNAVAILABLE_ELEMENT 
ToolkitException is thrown 




2 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with a null Text String TLV 

Text String TLV = OD 00 








Call the getTextStringCodingSchemeO method 


OUT_OF_TLV_BOUNDARIES 
ToolkitException is thrown 




3 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 01 h, dcs 

= 04h 

Text String TLV = OD 02 04 "A" 








Call the getTextStringCodingSchemeO method 


Result is 04h 




4 


Call the getValueLengthO method 


Result is 02h 




5 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 02h, 
DCS = OOh 

Text String TLV = OD 03 00 "BB" 









Call the getTextStringCodingSchemeO method 


Result is OOh 




6 


Call the getValueLengthO method 


Result is OSh 




7 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 





Terminal Response with text length = 7Eh, 
DCS = OSh 

Text String TLV = OD 7F 08 01 02 ... 7E 








Call the getTextStringCodingSchemeO method 


Result is OSh 




8 


Call the getValueLengthO method 


Result is 7Fh 




9 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 7Fh, 
DCS = 04h 

Text String TLV = OD 81 80 04 01 02 ... 7F 








Call the getTextStringCodingSchemeO method 


Result is 04h 




10 


Call the getValueLengthO method 


Result is BOh 
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Id 


Description 


API Expectation 


APDU Expectation 


11 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = EFh, 
DCS - OSh 

Text String TLV = OD 81 FO 08 01 02 ... EE 
EF 








Call the getTextStringCodingSchemeO method 


Result is OSh 




12 


Call the getValueLengthQ method 


Result is FOh 




13 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with 2 Text String TLV 

1st Text String TLV = OD 02 04 41 
2nd Text String TLV = OD 03 08 42 43 








Call the getTextStringCodingSchemeO method 


Result Is 04h 




14 


Call the getValueLengthQ method 


Result is 02h 





6.2.8.6.4 Test Coverage 



CRR number 


Test case number 


N1 


3, 5, 7, 9, 11, 13 


N2 


4, 6, 8, 10, 12, 14 


CI 


1 


02 


2 



6.2.8.7 Method GetTextStringLength 

Test Area Reference: API_2_PRH_GTTL. 
6.2.8.7.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getXextStringLength ( ) 

throws ToolkitException 

6.2.8.7. 1 . 1 Normal execution 

• CRRNl : The getTextStringLength() method returns the text string length value from the first Text String TLV 
element. 

• CRRN2: If a Text String TLV element is available, it becomes the TLV selected. 

6.2.8.7.1 .2 Parameter errors 
No requirements. 

6.2.8.7. 1 .3 Context errors 

• CRRCl : A ToolkitException.UNAVAILABLE_ELEMENT shall be thrown in case of unavailable Text String 
TLV element. 
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6.2.8.7.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.8.7.3 



Test Suite files 

API_2_PRH_GTTL_1 .scr 
API_2_PRH_GTTL_1 .Java 
API_2_PRH_GTTL_1 .Idr 
API_2_PRH_GTTL_1 .clr 
API_2_PRH_GTTL_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response (no Text String TLV 
element available) 








Call to getTextStringLengthQ with unavailable 
Text String TLV 


UNAVAILABLE_ELEMENT 
ToolkitException is thrown 




2 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 





Terminal Response with a null Text String TLV 

Text String TLV = OD 00 








Call the getTextStringLengthO method 


Result is OOh 




3 


Call the getValueLengthO method 


Result is OOh 




4 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 01 h, 
DCS = 04h 

Text String TLV = OD 02 04 "A" 








Call the getTextStringLengthO method 


Result is 01 h 




5 


Call the getValueLengthO method 


Result is 02h 




6 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 02h, 
DCS = OOh 

Text String TLV = OD 03 00 "BB" 








Call the getTextStringLengthO method 


Result is 02h 




7 


Call the getValueLengthO method 


Result is 03h 




8 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 7Eh, 
DCS = OBh 

Text String TLV = OD 7F 08 01 02 ... 7E 








Call the getTextStringLengthO method 


Result is 7Eh 




9 


Call the getValueLengthO method 


Result is 7Fh 
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Id 


Description 


API Expectation 


APDU Expectation 


10 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = 7Fh, 
DCS = 04h 

Text String TLV = OD 81 80 04 01 02 ... 7F 






Call the getTextStringLengthQ method 


Result is 7Fh 




11 


Call the getVaiueLengthQ method 


Result is BOh 




12 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with text length = EFh, 
DCS = 04h 

Text String TLV = OD 81 FO 04 01 02 ... EE 
EE 








Call the getTextStringLengthQ method 


Result is EFh 




13 


Call the getVaiueLengthQ method 


Result is FOh 




14 


Build and send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response with 2 Text String TLV 

1st Text String TLV = OD 02 04 41 

2nd Text String TLV = OD 03 08 42 43 








Call the getTextStringLengthQ method 


Result is 01 h 




15 


Call the getVaiueLengthQ method 


Result is 02h 





6.2.8.7.4 Test Coverage 



CRR number 


Test case number 


1 


2, 4, 6, 8, 10, 12, 14 


2 


3, 5, 7, 9, 11, 13, 15 


3 


1 



6.2.8.8 Method getTheHandler 

Test Area Reference: API_2_PRH_GTHD. 
6.2.8.8.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public static ProactiveResponseHandler getTheHandler ( ) 

throws ToolkitException 

6.2.8.8. 1 . 1 Normal execution 

• CRRNl: The method shall return the single system instance of the ProactiveHandler class. 

• CRRN2: The EnvelopeHandler is a Temporary JCRE Entry Point Object. 

6.2.8.8. 1 .2 Parameter errors 

No requirements. 
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6.2.8.8. 1 .3 Context errors 

• CRRCl : The method shall throw ToolkitException.HANDLER_NOT_AVAILABLE if the handler is busy. 



6.2.8.8.2 Test Suite files 



Test Script: 


API_ 


_2_ 


_PRH_ 


_GTHD_ 


_l.scr 


Test Applet: 


API. 


.2. 


PRH. 


.GTHD. 


.l.java 


Load Script: 


API. 


.2. 


.PRH. 


.GTHD. 


.l.ldr 


Cleanup Script: 


API. 


.2. 


.PRH. 


.GTHD. 


.l.clr 


Parameter File: 


API. 


.2. 


PRH. 


.GTHD. 


.l.par 



6.2.8.8.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a Proactive Command 




Proactive Command 




Terminal Response 








getTheHandlerQ twice 


The returned objects shall be the 
same 




2 


getTheHandierQ 


The reference shall be a 
ProactiveResponseHandler 




3 


getTheHandlerQ 


The reference shall not be null 





6.2.8.8.4 Test Coverage 



CRR number 


Test case number 


N1 


1, 2, 3 


N2 


To be checked in Framework tests and insert here cross reference 


CI 


To be checked in Framework tests and insert here cross reference 



6.2.8.9 Method getLength 

Test Area Reference API_2_PRH_GLEN. 
6.2.8.9.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short getLength () 

throws ToolkitException 

6.2.8.9.1.1 Normal execution 

• CRRN 1 : returns the length in bytes of the TLV list. 

6.2.8.9. 1 .2 Parameter errors 

No requirements. 

6.2.8.9. 1 .3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException.HANDLER_NOT_AVAILABLE. 
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6.2.8.9.2 Test Suite files 



Test Script: 


API. 


.2. 


.PRH. 


.GLEN. 


.l.scr 


Test Applet: 


API. 


.2. 


.PRH. 


.GLEN. 


.l.java 


Load Script: 


API. 


.2. 


.PRH. 


.GLEN. 


.l.ldr 


Cleanup Script: 


API. 


_2_ 


_PRH 


_GLEN_ 


_l.clr 


Parameter File: 


API. 


.2. 


.PRH. 


.GLEN. 


.l.par 



6.2.8.9.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Build and send a Display Text command 




DISPLAY TEXT Proactive 
command 




Terminal Response without additional 
information in General Result TLV 








ProactiveResponseHandler.getTheHandlerQ 

getLength ( ) 


Result of getLengthO is 12 




2 


Build and send a Display Text command 




DISPLAY TEXT Proactive 
command 




Terminal Response with F2h additional 
information in General Result TLV 








ProactiveResponseHandler.getTheHandierQ 
getLengthO 


Result of getLengthO is FFh 





6.2.8.9.4 Test Coverage 



CRR number 


Test case number 


N1 


1,2 


C1 


Does not apply for Proactive Response Handler 



6.2.8.10 Method copy 

Test Area Reference API_2_PRH_COPY_BSS. 
6.2.8.10.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short copy (byte [] dstBuffer, 
short dstOffset, 
short dstLength) 
throws java . lang .NullPointerException, 

java . lang .Array IndexOutOfBoundsExcept ion, 
ToolkitException 

6.2.8.10.1.1 Normal execution 

• CRRNl: copies the simple TLV Ust contained in the handler to the destination byte array. 

• CRRN2: returns dstOffset + dstLength. 

6.2.8.10.1.2 Parameter errors 

• CRRPl: if dstBuffer is null a NullPointerException is thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative, 
an ArraylndexOutOfBoundsException is thrown. 
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• CRRP3: if dstLength is grater than the length of the simple TLV List, an instance of TooLkitException shall be 
thrown. The reason code shall be ToolkitException. OUT_OF_TLV_BOUND ARIES. 



6.2.8.10.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 



6.2.8.10.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.8.10.3 



Test Suite files 

APl_2_PRH_C0PY_BSS_l.scr 
AP1_2_PRH_C0P Y_BSS_1 .Java 
API_2_PRH_COPY_BSS_l .Idr 
API_2_PRH_COPY_BSS_l .clr 
API_2_PRH_COPY_BSS_l .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response without Additional 
Information in General Result TLV: 

81 03 01 21 00 02 02 82 81 03 01 00 








ProactiveResponseHandler.getTheHandierQ 
copyO with NULL as parameter to dstBuffer 


NullPointerException is thrown 




2 


dstOffset > dstBuffer.length 

dstBuff er . length = 5 
dstOffset = 6 
dstLength = 


ArravlndexOutOfBoundsExceotio 
n Is thrown 




3 


dstOffset < 

dstBuffer.length = 5 

dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n Is thrown 




4 


dstLength > dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n Is thrown 




5 


dstOffset + dstLength > dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n Is thrown 




6 


dstLength < 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n Is thrown 




7 


dstLength > length of the simple TLV list 

dstBuffer.length = 13 
dstOffset = 
dstLength = 13 


ToolkitException. OUT OF TLV 
BOUNDARIES is thrown 




8 


Successful call, dstBuffer is the whole buffer 

dstBuffer.length = 12 
dstOffset = 
dstLength = 12 


Result of copyO Is 12 




9 


Compare the buffer with buffer: 

81 03 01 21 00 02 02 82 81 03 01 00 


Result of arrayCompareO Is 




10 


Successful call, dstBuffer is part of a buffer 

dstBuffer.length = 20 
dstOffset = 3 
dstLength = 12 


Result of copyO Is 15 
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IQ 


uescnpiion 


Ari cxpeciaiion 


Aruu cxpeciaiion 




compare me wnoie Duner 


RGSult of arrayCompareO is 






Reference = 








00 OT 09 

WW W -L W 








81 03 01 21 GO 








09 09 89 81 

wZ, wZ, OZ, 0_L 








03 01 00 








OF 10 11 12 13 






1 2 


Initializp d^tBuffpi* 

1 1 1 1 11 CI 1 1^ V VI V \ VI 1 1 W 1 








H'^fRiifff^r = OOh Olh 09h 








Successful call, dstBuffer is part of a buffer 


— j- — —. — — — 

Result of copyO is 12 






dstBuff er . length = 20 








dstOffset = 3 














13 


Compare the wliole buffer 


Result of arrayCompareO is 






Reference = 








00 01 02 








81 03 01 21 00 








02 02 82 81 








OC OD OE 








OF 10 11 12 13 







6.2.8.10.4 Test Coverage 



CRR number 


Test case number 


N1 


9, 11, 13 


N2 


8, 10, 12 


P1 


1 


P2 


2, 3, 4, 5, 6 


P3 


7 


C1 


Does not apply for Proactive Response Handler 



6.2.8.11 Method findTLV 

Test Area Reference API_2_PRH_FINDBB. 
6.2.8.1 1.1 Conformance requirement 

The method with following header shall be compliant to its definition in the APT 

public byte findTLV (byte tag, byte occurrence) 
throws ToolkitException 

6.2.8.1 1.1.1 Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of the TLV list (handler buffer): 

• CRRNl: the method is successful if the required occurrence exists then the corresponding TLV becomes current. 

• CRRN2: if the method is successful then it returns TLV_FOUND_CR_SET when Comprehension Required flag 
is set. 

• CRRN3: if the method is successful then it returns TLV_FOUND_CR_NOT_SET when Comprehension 
Required flag is not set. 

• CRRN4: if the required occurrence of the TLV element does not exist, the current TLV is no longer defined and 
TLV_NOT_FOUND is returned. 

• CRRN5: The search method is comprehension required flag independent. 

6.2.8.11.1.2 Parameter errors 

• CRRPl: if an input parameter is not vahd (e.g. occurrence = 0) an instance of ToolkitException shall be thrown. 
The reason code shall be ToolkitException BAD_INPUT_PARAMETER. 
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6.2.8.1 1 .1 .3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 



6.2.8.11.2 Test Suite files 



Test Script: 


API. 


.2. 


.PRH. 


.FINDBB. 


.l.scr 


Test Applet: 


API. 


.2. 


.PRH. 


.FINDBB. 


.l.java 


Load Script: 


API. 


.2. 


.PRH. 


.FINDBB. 


.l.ldr 


Cleanup Script: 


API. 


.2. 


PRH. 


.FINDBB. 


.l.clr 


Parameter File: 


API. 


.2. 


PRH. 


.FINDBB. 


.l.par 



6.2.8.1 1 .3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a DISPLAY TEXT command 




DISPLAY TEXT Proactive 
command 




Terminal Response with 2 General Result TLV 

81 03 01 21 00 

82 02 82 81 
03 01 00 

03 02 01 12 








flndTLVQ with Invalid input parameter 

occurrence = 


ToolkitException. BAD_INPUT_PA 
RAIVIETER Is tlirown 




2 


Search 1st TLV 

tag = Olh 
occurrence = 1 


Result is TLV_FOUND_CR_SET 




3 


Call the getValueLengthO method 


Result Is 03li 




4 


Search 2nd TLV 

tag = 02h 
occurrence = 1 


Result is TLV_FOUND_CR_SET 




5 


Call the getValueLengthO method 


Result is 02h 




6 


Select a TLV (tag 02h) 








Search a wrong tag 

tag = 04h 
occurrence = 1 


Result is TLV_NOT_FOUND 




7 


Call the getValueLengthO method 


ToolkitException. UNAVAILABLE_ 
ELEMENT shall be thrown 




8 


Search a tag with wrong occurrence 

tag = Olh 
occurrence = 2 


Result is TLV_NOT_FOUND 




9 


Call the getValueLengthO method 


ToolkitException. UNAVAILABLE 
ELEMENT shall be thrown. 




10 


Search 3rd TLV 

tag = 03h 
occurrence = 1 


Result Is 

TLV_FOUND_CR_NOT_SET 




11 


Call the getValueLengthO method 


Result Is Olh 




12 


Search 3rd TLV 

tag = 03h 

occurrence = 2 


Result Is 

TLV_FOUND_CR_NOT_SET 




13 


Call the getValueLengthO method 


Result Is 02h 




14 


Search tag 83h 

Tag = 83h 
Occurrence = 1 


F^6SLilt is 

TLV_FOUND_CR_NOT_SET 




15 


Search tag 82h 

Tag = 82h 
Occurrence = 1 


Result is TLV_FOUND_CR_SET 
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6.2.8.1 1 .4 Test Coverage 



CRR number 


Test case number 


N1 


3, 5, 11, 13 


N2 


2, 4 


N3 


10, 12 


N4 


6, 7,8, 9 


N5 


14,15 


P1 


1 


C1 


Does not apply for Proactive Response Handler 



6.2.8.12 Method getValueLength 

Test Area Reference API_2_PRH_GVLE. 

6.2.8.12.1 Conformance requirement 

The method with following header shall be compliant to its definition in the APT 

public short getValueLength ( ) 

throws ToolkitException 

6.2.8.12.1.1 Normal execution 

• CRRNl : gets and returns the binary length of the value field for the last TLV element which has been foimd in 
the handler. 

6.2.8.12.1.2 Parameter errors 
No requirements. 

6.2.8.12.1 .3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code 
shall be ToolkitException UNAVAILABLE_ELEMENT. 

6.2.8.12.2 Test Suite files 

Test Script: API_2_PRH_GVLE_l.scr 

Test Applet: API_2_PRH_GVLE_l.java 

Load Script: API_2_PRH_GVLE_l.ldr 

Cleanup Script: API_2_PRH_GVLE_ 1 .clr 

Parameter File: API_2_PRH_GVLE_1 .par 
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6.2.8.12.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response 

Text String TLV = OD 00 








ProactlveResponselHandler.getTheHandlerO 

GetValueLength 


ToolkitException.UNAVAILABLE_ 
ELEMENT is thrown 




2 


Search TLV ODh 








getValueLength ( ) 


Result is OOh 




3 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response 

Text String TLV = OD 02 04 41 








Search TLV ODh (Text String TLV) 








getValueLength ( ) 


Result is 02h 




4 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 7Eh 

Text String TLV = OD 7F 04 01 02 ... 7E 








Search TLV ODh (Text String TLV) 








getValueLength ( ) 


Result is 7Fh 




5 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 7Fh 

Text String TLV = OD 81 80 04 01 02 ... 7E 

7F 








Search TLV ODh (Text String TLV) 








getValueLength () 


Result is 80h 




6 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = EFh 

Text String TLV = OD 81 FO 04 01 02 ... EF 








Search TLV ODh (Text String TLV) 








getValueLength ( ) 


Result is FOh 





6.2.8.12.4 Test Coverage 



CRR number 


Test case number 


N1 


2, 3, 4, 5, 6 


C1 


Does not apply for Proactive Response Handler 


C2 


1 



6.2.8.13 Method getValueByte 

Test Area Reference API_2_PRH_GVBYS. 
6.2.8.13.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte getValueByte (short valueOffset) 
throws ToolkitException 
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6.2.8.13.1.1 Normal execution 

• CRRNl : Gets a byte from the last TLV element which has been found in the handler and returns its value (1 
byte). 

6.2.8.13.1 .2 Parameter errors 

• CRRPl : if valueOffset is out of the current TLV an instance of ToolkitException shall be thrown. The reason 
code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

6.2.8.13.1.3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code 
shall be ToolkitException UNAVAILABLE_ELEMENT. 



6.2.8.13.2 Test Suite files 



Test Script: 


API. 


.2. 


PRH. 


.GVBYS. 


.l.scr 


Test Applet: 


API. 


.2. 


PRH. 


.GVBYS. 


.l.java 


Load Script: 


API. 


.2. 


PRH. 


.GVBYS. 


.l.ldr 


Cleanup Script: 


API. 


.2. 


PRH. 


.GVBYS. 


.l.ck 


Parameter File: 


API. 


.2. 


PRH. 


.GVBYS. 


.l.par 



6.2.8.13.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 7Eh 

Text String TLV = OD 7F 04 01 02 ... 7E 








ProactiveResponseHandler.getTheHandlerQ 








getValueByte (0) 


ToolkitException . UNAVAI LABLE 
ELEMENT is thrown 




2 


Search TLV 01 h (Command Details TLV) 








getValueByte (3) 


ToolkitException. OUT_OF_TLV_ 
BOUNDARIES is thrown 




3 


Search TLV 01 h (Command Details TLV) 






getValueByte (2) 


Result Is OOh (qualifier) 




4 


Search TLV 02h (Device Identities TLV) 








getValueByte (0) 


Result is 82li (Source) 




5 


Search TLV ODh (Text String TLV) 








getValueByte (7E) 


Result is 7Eh 




6 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = EFh 

Text String TLV = OD 81 FO 04 01 02 ... 7E 
7F ... EF 








Search TLV ODh (Text String TLV) 








getValueByte (7E) 


Result is 7Eh 




7 


GetValueByte (7F) 


Result is 7Fh 




8 


GetValueByte (EF) 


Result is EFh 
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6.2.8.13.4 



Test Coverage 



CRR number 


Test case number 


N1 


3, 4, 5, 6, 7, 8 


P1 


2 


C1 


Does not apply for Proactive Response Handler 


C2 


1 



6.2.8.14 Method copyValue 

Test Area Reference API_2_PRH_CPYVS_BSS. 
6.2.8.14.1 Conformance requirement 

The method with following header shall be compliant with its definition in the API. 

public short copyValue ( short valueOffset, 

byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsException, 
ToolkitException 

6.2.8.14.1.1 Normal execution 

• CRRNl : copies a part of the last TLV element which has been found, into a destination, buffer. 

• CRRN2: returns dstOffset + dstLength. 

6.2.8.14.1 .2 Parameter errors 

• CRRPl : if dstBuffer is nuU NullPointerException is thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException is thrown. 

• CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUNDARlES. 



6.2.8.14.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code 
shall be ToolkitException UNAVAILABLE_ELEMENT. 



6.2.8.14.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 



Test Suite files 

API_2_PRH_CPYVS_BSS_1 .scr 
API_2_PRH_CPYVS_BSS_1 .java 
APl_2_PRH_CPYVS_BSS_l.ldr 
API_2_PRH_CPYVS_BSS_1 .ch 
API_2_PRH_CPYVS_BSS_1 .par 



ETSI 



3GPP TS 11 .1 3 version 8.2.1 Release 1 999 21 4 ETSI TS 1 01 955 V8.2.1 (2003-04) 



6.2.8.14.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Tprminal Rp^nnn^p Tpxt 5^trinn Ipnnth — ^ 

Text String TLV = OD 06 04 01 02 ... 05 








ProactlveResponseHandler.getTheHandlerO 

Select Text String TLV 








CopyVslue ( ) with sl null dstBuf f er 


NullPointerException is thrown 




2 


dstOffset > dstBuffer.length 

dstBuff er . length = 5 
dstOffset = 6 
dstLength = 


ArraylndexOutOfBoundsExceptio 
n is tiirown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength >dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 

dstLength = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength >dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


valueOffset > Text String Length 

valueOffset = 7 
dstBuffer.length = 15 
dstOffset = 
dstLength = 


Tooll<itException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
dstBuffer.length = 15 
dstOffset = 

dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


dstLength > Text String length 

valueOffset = 
dstBuffer.length = 15 
dstOffset = 
dstLength = 7 


ToolkitException.OUT_OF_TLV_ 
BOUNDARIES is thrown 




10 


ValueOffset + dstLength > Text String length 

ValueOffset = 2 
DstBuffer.length = 15 
DstOffset = 
DstLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler . getTheHandler 








CopyValue ( ) 


ToolkitException.UNAVAILABLE_ 
ELEMENT is thrown 




12 


Select Text String TLV 








Successful call 

ValueOffset = 
DstBuffer.length = 17 
DstOffset = 
DstLength = 17 


Result of copyValueO is 17 




13 


Compare buffer 

Buffer = 04 00 01 ... OF 


Result is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


14 


initialize dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 


Result of copyValueO is 15 






ValueOffset = 2 








DstBuffer . length = 20 
















DstLength = 12 






15 


Compare buffer 

Buffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 


Result is OOh 





6.2.8.14.4 Test Coverage 



CRR number 


Test case number 


N1 


13, 15 


N2 


12, 14 


PI 


1 


P2 


2, 3, 4, 5, 6 


P3 


7, 8, 9, 10 


CI 


Does not apply for Proactive Response Handler 


C2 


11 



6.2.8.15 Method compare Value 

Test Area Reference API_2_PRH_CPRVS_BSS. 
6.2.8.15.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte compareValue (short valueOffset, 

byte[] compareBuf f er ^ 
short compareOf f set , 
short compareLength) 
throws java . lang .NullPointerException, 

java . lang .Array IndexOutOfBoundsExcept ion, 
ToolkitException 

6.2.8.15.1.1 Normal execution 
Compares the last found TLV element with a buffer: 

• CRRNl : returns if identical. 

• CRRN2: returns -1 if the first miscomparing byte in simple TLV List is less than that in compareBuffer. 

• CRRN3: returns 1 if the first miscomparing byte in simple TLV List is greater than that in compareBuffer. 

6.2.8.15.1 .2 Parameter errors 

• CRRPl: if compareBuffer is nuU NullPointerException shall be thrown. 

• CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if 
compareLength is negative ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 



ETSI 



3GPP TS 11.13 version 8.2.1 Release 1999 



216 



ETSI TS 101 955 V8.2.1 (2003-04) 



6.2.8.15.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

• CRRC2: in case of unavailable TLV element an instance of ToolkitException shall be thrown. The reason code 
shall be ToolkitException UNAVAILABLE_ELEMENT. 



6.2.8.15.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.8.15.3 



Test Suite files 

API_2_PRH_CPRVS_BSS_1 .scr 
API_2_PRH_CPRVS_BSS_1 .Java 
API_2_PRH_CPRVS_BSS_1 .Idr 

API_2_PRH_CPRVS_BSS_1 .ck 
API_2_PRH_CPRVS_BSS_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 5 

Text String TLV = OD 06 04 01 02 ... 05 








ProactiveResponseHandler.getTheHandlerO 

Select Text String TLV 









compareVaiueQ with a null compareBuffer 


NullPointerException is thrown 




2 


compareOffset > compareBuffer.length 

compareBuff er . length = 5 
compareOffset = 6 
compareLength = 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


compareOffset < 

compareBuffer.length = 5 
compareOffset = -1 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareLength >compareBuffer.length 

compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


compareOffset + compareLength 
>compareBuffer.length 

compareBuffer.length = 5 
compareOffset = 3 
compareLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


compareLength < 

compareBuffer.length = 5 
compareOffset = 
compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


valueOffset > Text String Length 

valueOffset = 7 
compareBuffer.length = 15 
compareOffset = 
compareLength = 


ToolkitException. OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
compareBuffer.length = 15 
compareOffset = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




9 


compareLength > Text String length 

valueOffset = 
compareBuffer.length = 15 

compareOffset = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


10 


valueOffset + compareLengtli > Text String 
iength 

valueOffset = 2 
compareBuff er . length = 15 
compareOf f set = 
compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler . getTheHandler { ) 








CompareValue ( ) 


ToolkitException.UNAVAILABLE_ 
ELEMENT is thrown 




12 


Select Text String TLV 








Initialize coirmareRufter 

CompareBuffer = 
04 00 01 ... OF 








Comnarp buffers 

ValueOffset = 
CompareOf f set = 
CompareLength = 17 






13 


Initialize compareBuffer 

CompareBuffer = 
04 00 01 ... 10 








Compare buffers with same parameters 


Result is -1 




14 


Initialize compareBuffer 

CompareBuffer = 
03 00 01 ... OF 








Comnarp buffers with ^amp naram^tprs 

III mj^t 1 w VI 1 1 W 1 w VV III 1 1 1 1 V 1^ 1 Ql 1 Iwl w 


RpCllIt IQ 4-1 




15 


Initialize compareBuffer 

CompareBuffer = 
55 55 55 01 02 
03 04 05 Ofi 07 

kI I 

08 09 OA OB OC 
55 55 55 55 55 








Compare buffers 

ValueOffset = 2 

CompareOf f set = 3 

\^ LJl L L k_/ cl i- ^ J-iCr i 1 y L-ll — J_ ^ 


Result is OOh 




1 6 


Initialize cntrmareBuffer 

1 1 1 1 HQ 1 1^^ w^/l 1 1 Um U 1 1 V 1 

CompareBuffer = 
55 55 55 02 01 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Comnare buffers with same narameters 

III I^Cll ^7 ^/U 1 1^71 w VW 1 & I 1 wm 1 1 w I^QI Cll 1 ^wl w 


Rpci lit Iq -1 

1 ICOU 1 L lO 1 




17 


Initialize compareBuffer 

CompareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OA OD 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 
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CRR number 

1111 II U III 1^^^ 1 


Test ca^p number 

1 WW^C 1 lU 1 1 lli/d 


N1 


12, 15 


N2 


13, 16 


N3 


14, 17 


P1 


1 


P2 


2,3,4, 5,6 


P3 


7, 8, 9, 10 


C1 


Does not apply for Proactive Response Handler 


C2 


11 



6.2.8.16 Method f indAndCopyValue(byte tag, byte[] dstBuff er, short valueOffset) 

Test Area Reference API_2_PRH_FACYB_BS. 
6.2.8.16.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short f indAndCopyValue (byte tag, 

byte[] dstBuffer, 
short dstOffset) 
throws java . lang .NullPointerException, 

java . lang .Array IndexOutOfBoundsExcept ion, 
ToolkitException 

6.2.8.16.1.1 Normal execution 

• CRRN 1 : looks for the first occurrence of a TLV element from the beginning of a TLV list and copy its value into 
a destination buffer. 

• CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 

TLV is no longer defined. 



CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + length of the 
copied value is returned. 



• CRRN4: The search method is comprehension required fiag independent. 

6.2.8.16.1 .2 Parameter errors 

• CRRPl : if dstBuffer is nuU NullPointerException shall be thrown. 

• CRRP2: if dstOffset would cause access outside array bounds ArraylndexOutOfBoundsException shall be 
thrown. 

6.2.8.16.1.3 Context errors 

• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 

6.2.8.16.2 Test Suite files 

Test Script: API_2_PRH_FACYB_BS_Lscr 

Test Applet: API_2_PRH_FACYB_BS_1 .java 

Load Script: API_2_PRH_FACYB_BS_l.ldr 

Cleanup Script: API_2_PRH_FACYB_BS_Lch 

Parameter File: API_2_PRH_FACYB_BS_1 .par 
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6.2.8.16.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 15 

Text String TLV = OD 10 04 01 02 ... OF 








ProactiveResponseHandler . getTheHandler ( ) 








FindAndCopyValue ( ) with a null dstBuffer 


NullPointerException is thrown 




o 

d. 


astuttset > astDUTter.iengtn 

tag = ODh 

dstBuff er . length = 20 
dstOffset = 21 


ArraylndexOutOfBoundsExceptio 
n is thrown 




o 
o 


dstBuffer. length = 20 
dstOffset = -1 


A ri'fai#l nrtQ VIII i+iitD^i inrtoCv^Qi^+in 

Mrrdy iriucAV.jULwi DuuiiubcxucpLiu 
n is thrown 




4 


length > dstBuffer.length 

dstBuffer. length = 15 
dstOffset = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + length >dstBuffer.length 

dstBuffer.length = 20 
dstOffset = 5 


Array 1 ndexOutOfBoundsExceptio 
n is thrown 




6 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactlveResponseHandler.getTheHandlerO 








Select a TLV (tag 02h) 








findAndCopyValueO 

tag = 04h 


Tooll<itException. UNAVAILABLE 
ELEIVIENT is thrown 






Call the getValueLengthO method 


ToolkitException . UNAVAI LABLE_ 
ELEMENT is thrown. 




7 


Successful call 

Tag = ODh 

DstBuffer.length = 17 
DstOffset = 


Result of findAndcopyValueQ is 
17 




8 


Compare buffer 

Buffer = 04 00 01 ... OF 


Result is OOh 




9 


Initialize dstBuffer 

dstBuffer = 55 55 ... 55 








Successful call 

DstBuffer.length = 20 
DstOffset = 2 


Result of findAndcopyValueQ is 
19 




10 


Compare buffer 

Buffer = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 


Result is OOh 




1 1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, with 2 Text String TLV 

OD 11 04 00 01 ... OF 
OD 02 04 41 








ProactlveResponseHandler.getTheHandlerO 








Successful call 

Tag = ODh 

DstBuffer.length = 17 
DstOffset = 


Result of findAndcopyValueQ is 
17 




12 


Compare buffer 

Buffer = 04 00 01 ... OF 


Result is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


13 


Send a GET INPUT command 




GET INPUT Proactive 
command 


Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler.getTheHandlerO 








Successful call (with tag SDh) 

Tag = SDh 

DstBuffer. length = 17 
DstOffset = 


Result of findAndcopyValueO is 
17 




14 


Compare buffer 

Buffer = 04 00 01 ... OF 


Result is OOh 





6.2.8.16.4 Test Coverage 



CRR number 


Test case number 


N1 


8, 10, 12 


N2 


6 


N3 


7, 9, 11 


N4 


13, 14 


P1 


1 


P2 


2, 3, 4, 5 


C1 


Does not apply for Proactive Response Handler 



6.2.8.17 Method findAndCopyValue(byte tag, byte occurence, short valueOffset, byte[] 
dstBuffer, short dstOffset, short dstLength) 

Test Area Reference API_2_PRH_FACYBBS_BSS. 
6.2.8.17.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public short f indAndCopyValue (byte tag, 

byte occurence, 
short valueOffset, 
byte[] dstBuffer, 
short dstOffset, 
short dstLength) 
throws java . lang .NullPointerException, 

java . lang .Array IndexOutOfBoundsExcept ion, 
ToolkitException 

6.2.8.17.1.1 Normal execution 

• CRRN 1 : looks for the indicated occurrence of a TLV element from the beginning of a TLV list and copy its 
value into a destination buffer. 

• CRRN2: if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN3: if the method is successful then the corresponding TLV becomes current and dstOffset + dstLength is 
returned. 

• CRRN4: The search method is comprehension required flag independent. 

6.2.8.17.1.2 Parameter errors 

• CRRPl: if dstBuffer is null NullPointerException shall be thrown. 

• CRRP2: if dstOffset or dstLength or both would cause access outside array bounds, or if dstLength is negative 
ArraylndexOutOfBoundsException shall be thrown. 
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• CRRP3: if valueOffset, dstLength or both are out of the current TLV an instance of ToolkitException shall be 
thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUNDARIES. 



6.2.8.17.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 



6.2.8.17.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.8.17.3 



Test Suite files 

API_2_PRH_FACYBBS_BSS_l.scr 
API_2_PRH_FACYBBS_BSS_1 .Java 
API_2_PRH_FACYBBS_BSS_1 .Idr 
API_2_PRH_FACYBBS_BSS_1 .clr 
API_2_PRH_FACYBBS_BSS_1 .par 

Test procedure 



IH 

lU 








1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




lerminai nesponse, lexi oinng lenyin = io 

Text String TLV = OD 10 04 01 02 ... OF 








ProactiveResponseHandler.getTheHandlerO 








flndAndCopyValueQ with a null dstBuffer 


NullPolnterExceptlon is thrown 




2 


dstOffset > dstBuffer.length 

tag = ODh, occurrence = 1 
valueOffset = 
dstBuffer.length = 5 
dstOffset = 6 
dstLength = 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


dstOffset < 

dstBuffer.length = 5 
dstOffset = -1 
dstLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


dstLength > dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 
dstLength = 6 


ArraylndexOutOfBoundsExceptio 
n is thrown 




5 


dstOffset + dstLength > dstBuffer.length 

dstBuffer.length = 5 
dstOffset = 3 
dstLength = 3 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


dstLength < 

dstBuffer.length = 5 
dstOffset = 
dstLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 5 

Text String TLV = OD 06 04 01 02 ... 05 








ProactiveResponseHandler.getTheHandlerQ 








valueOffset > Text String Length 

tag = ODh, occurrence = 1 
valueOffset = 7 
dstBuffer.length = 15 
dstOffset = 
dstLength = 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
dstBuffer.length = 15 
dstOffset = 
dstLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


9 


dstLength > Text String length 

valueOffset = 
dstBuff er . length = 15 

dstLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + dstLength > Text String length 

valueOffset = 2 
dstBuff er . length = 15 
dstOffset = 
dstLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




11 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler.getTheHandlerO 








Select a TLV (tag 02h) 









findAndCopyValueQ 

tag = ODh 
occurrence = 2 


ToolkitExceptlon . UNAVAI LABLE_ 
ELEMENT is thrown 






Call the aefValupLpnathn method 


ToolkitExrptition UNAVAILABLE 
ELEMENT is thrown. 




12 


Successful call 

T ;^ rr = OFlVi r^- i^n t" r'on i^o = 1 

±Ciy — \J lJ lL f WL-L-Lli-i-^il^si — -L 

ValueOffset = 
DstBuffer . length = 17 
DstOffset = 
DstLength = 17 


Result of findAndCopyValueO is 

\ 1 




13 


Compare buffer 

Buffer = 04 00 01 ... OF 


Result is OOh 






iniiiaiize usiDUTier 

dstBuffer = 55 55 ... 55 








Successful call 

Tag = ODh, occurrence = 1 
ValueOffset = 2 
DstBuffer . length = 20 
UstUr r set — o 
DstLength = 12 


Result of findAndcopyValueO is 
15 




1 


nnmnflrp hiiffpr 

Buffer = 

55 55 55 01 02 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 


Rpei lit iQ nnh 




16 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, with 2 Text String TLV 

OD 11 04 00 01 02 ... OF 

OD 06 00 11 22 33 44 55 (no specific DCS 
byte) 








ProactiveResponseHandler.getTheHandlerO 








Successful call 

ValueOffset = 
DstBuffer . length = 17 
DstOffset = 
DstLength = 17 


Result of findAndCopyValueO is 

\ 1 




17 


Compare buffer 

Rn-p-For = 04 DO 01 OF 


Result is OOh 




18 


Successful call 

Tag = ODh, occurrence = 2 
ValueOffset = 
DstBuffer. length = 6 
DstOffset = 
DstLength = 6 


Result of findAndCopyValueO is 6 




19 


Compare buffer 

Buffer = 00 11 22 33 44 55 


Result is OOh 
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Id 


Description 


API Expectation 


APDU Expectation 


20 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler.getTheHandlerO 









Successful call (with tag SDh) 

Tag = SDh, occurrence = 1 


Result of findAndcopyValueO is 
■\j 






ValueOffset = 








DstBuffer. length = 17 








DstOffset = 








DstLength =17 






21 


Compare buffer 

Buffer = 04 00 01 ... OF 


Result is OOh 





6.2.8.17.4 Test Coverage 



CRR number 


Test case number 


N1 


13, 15, 17, 19 


N2 


11 


N3 


12, 14, 16, 18 


N4 


20, 21 


PI 


1 


P2 


2, 3, 4, 5, 6 


P3 


7, 8, 9, 10 


CI 


Does not apply for Proactive Response Handler 



6.2.8.18 Method findAndCompareValue(byte tag, byte[] compareBuffer, short 
compareOffset) 

Test Area Reference API_2_PRH_FACRB_BS. 
6.2.8.18.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public byte f indAndCompareValue (byte tag, 

byte [] compareBuffer, 
short compareOffset) 
throws java . lang . NullPointerException, 

java . lang . ArraylndexOutOf BoundsException, 
ToolkitException 

6.2.8.18.1.1 Normal execution 

Looks for the first occurrence of a TLV element from beginning of a TLV list and compare its value with a buffer: 

• CRRN 1 : if no TLV element is found, the UNAVAILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN2: if the method is successful then the corresponding TLV becomes current. 

• CRRN3 : if identical returns 0. 

• CRRN4: if the first miscomparing byte in simple TLV is less than that in compareBuffer returns -L 

• CRRN5: if the first miscomparing byte in simple TLV is greater than that in compareBuffer returns L 

• CRRN6: The search method is comprehension required flag independent. 

6.2.8.18.1 .2 Parameter errors 

• CRRPL if compareBuffer is nuU NullPointerException shall be thrown. 
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• CRRP2: if compareOffset would cause access outside array boimds ArraylndexOutOfBoimdsException shall be 
thrown. 



6.2.8.18.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitExceptionHANDLER_NOT_AVAILABLE. 



6.2.8.18.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.8.18.3 



Test Suite files 

AP1_2_PRH_FACRB_BS_1 .scr 
AP1_2_PRH_FACRB_BS_1 .Java 
API_2_PRH_FACRB_BS_1 .Idr 
API_2_PRH_FACRB_BS_1 .clr 
API_2_PRH_FACRB_BS_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


■i 


oena a i inku i coniinanQ 




r^CT IMDI IT Drr\^r*i\\iA 

ot 1 iNru 1 rroactive 
command 




Terminal Response, Text String length = 15 

Text String TLV = OD 10 04 01 02 ... OF 








ProactlveResponseHandler.getTheHandlerQ 








FindAndCompareValueO with a null dstBuffer 


NullPointerException is thrown 




2 


compareOffset > compareBuffer.length 

tag = ODh 

compareBuffer.length = 20 
compareOffset = 21 


ArraylndexOutOfBoundsExceptio 
n is thrown 




3 


compareOffset < 

compareBuffer.length = 20 
compareOffset = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


length > compareBuffer.length 

compareBuffer.length = 15 
compareOffset = 


Array 1 ndexOutOfOoundsExceptio 
n is thrown 




5 


CompareOffset + length > 

compareBuf f er . length 
CompareBuffer.length = 20 
CompareOffset = 5 


ArraylndexOutOfBoundsExceptio 
n is thrown 




6 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactiveResponseHandler.getTheHandlerO 








Select a TLV (tag 02h) 








findAndCompareValueO 

tag = 04h 


Tooll<itException . UNAVAI U\BLE 
ELEIVIENT is thrown 






Call the getValueLengthO method 


ToolkitException. UNAVAIU\BLE_ 
ELEMENT is thrown. 




7 


initialize compareBuffer 

CompareBuf fer = 
04 00 01 ... OF 








Compare buffers 

Tag = ODh 
CompareOffset = 


Result is OOh 




8 


Verify current TLV 

GetValueLength 


Result is 17 




9 


initialize compareBuffer 

CompareBuffer = 
04 00 01 ... 10 








Compare buffers with same parameters 


Result is -1 
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Id 


Description 


API Expectation 


APDU Expectation 


10 


Initialize compareBuffer 

CompareBuffer = 
03 00 01 ... OF 








Comnare buffers with same Darameters 

III I^Cll ^/U 1 l^^l w TV 1 & I 1 wdl 1 1 w 1^01 Cll 1 l^^lwl w 


Ppci lit ic -lI 




11 


Initialize compareBuffer 

CornpsiTsBuf f SIT = 
55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 








Compare buffers 

CompareOf f set = 2 


Result is OOh 




12 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, with 2 Text String TLV 

OD 11 04 00 01 ... OF 

OD 06 00 11 22 33 44 55 








ProactlveResponseHandler.getTheHandierO 








Initialize compareBuffer 

V, L.^ 1 L L kJ a._Lt^£jm_L_Lt:_L — 

55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 









Compare buffers 

f^l^TYlT^a T*"0 "F "F Q Cl"l" = 

'^^jiLt^ci J- -L j_ o t; L. — ^ 


Result is OOh 




13 


Initialize compareBuffer 

f^i^TYiT^a T~CiRn "f" "f" d T~ = 

^ V.J1L1L./CL i- tli X_> La J_ J_ -L — 

55 55 04 01 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OE OF 55 









Compare buffers 

f^l^TYlT^a T*"0 "F "F Q Cl"l" = 

'^^JlLi^Cl J- tSW -L X o t; L. — ^ 


Result is -1 




14 


Initialize compareBuffer 

^ ^^ILLkn' Cli-CrDLl-L-Lcr-L — 

55 55 04 00 01 
02 03 04 05 06 
07 08 09 OA OB 
OC OD OD 10 55 








Compare buffers 

CompareOf f set = 2 


Result is +1 




15 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactlveResponseHandier.getTheHandierO 








Initialize compareBuffer 

CompareBuffer = 
04 00 01 ... OF 








Compare buffers (with tag SDh) 

Tag = 8Dh 
CompareOf f set = 


Result is OOh 
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HRR niimhpr 


Tp^t cfl^p niimhpr 


N1 




N2 


8 


N3 


7, 11, 12 


N4 


9, 13 


N5 


10, 14 


N6 


15 


P1 


1 


P2 


2, 3, 4, 5 


C1 


Does not apply for Proactive Response Handler 



6.2.8.19 Method findAndCompareValue(byte tag, byte occurence, short valueOffset, 
byte[] compareBuffer, short compareOffset, short compareLength) 

Test Area Reference API_2_PRH_FACRBBS_BSS. 
6.2.8.19.1 Conformance requirement 

The method with following header shall be compliant to its definition in the APT 

public byte f indAndCompareValue (byte tag, 

byte occurence, 
short valueOffset, 
byte [ ] compareBuffer, 
short compareOffset, 
short compareLength) 
throws java . lang .NullPointerException, 

java . lang .Array IndexOutOfBoundsExcept ion, 
ToolkitException 

6.2.8.19.1.1 Normal execution 

Looks for the indicated occurrence of a TLV element from the beginning of a TLV Ust and compare its value with a 
buffer: 

• CRRN 1 : if no TLV element is found, the UN AV AILABLE_ELEMENT exception is thrown and the current 
TLV is no longer defined. 

• CRRN2: if the method is successful then the corresponding TLV becomes current. 

• CRRN3: if identical is returned. 

• CRRN4: if the first miscomparing byte in simple TLV is less than that in compareBuffer -1 is returned. 

• CRRN5: if the first miscomparing byte in simple TLV is greater than that in compareBuffer 1 is returned 

• CRRN6: The search method is comprehension required flag independent. 

6.2.8.19.1.2 Parameter errors 

• CRRPl: if compareBuffer is nuU NullPointerException shall be thrown. 

• CRRP2: if compareOffset or compareLength or both would cause access outside array bounds, or if 
compareLength is negative ArraylndexOutOfBoundsException shall be thrown. 

• CRRP3: if valueOffset, compareLength or both are out of the current TLV an instance of ToolkitException shall 
be thrown. The reason code shall be ToolkitException OUT_OF_TLV_BOUND ARIES. 

• CRRP4: if an input parameter is not vahd (e.g. occurence = 0) an instance of ToolkitException shall be thrown. 
The reason code shall be ToolkitException BAD_INPUT_PARAMETER. 
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6.2.8.19.1.3 



Context errors 



• CRRCl : if the handler is busy an instance of ToolkitException shall be thrown. The reason code shall be 
ToolkitException HANDLER_NOT_AVAILABLE. 



6.2.8.19.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.8.19.3 



Test Suite files 

API_2_PRH_FACRBBS_BSS_1 .scr 
API_2_PRH_FACRBBS_BSS_1 .Java 
API_2_PRH_FACRBBS_BSS_1 .Idr 
API_2_PRH_FACRBBS_BSS_1 .cb- 
API_2_PRH_FACRBBS_BSS_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 15 

Text String TLV = OD 10 04 01 02 ... OF 









ProactlveResponseHandler.getTheHandlerO 








findAndCompareValueO with a null 
compareBuffer 


NullPointerException is thrown 




2 


compareOffset > compareBuffer.length 

tag = ODh, occurrence = 1 
valueOffset = 
compareBuffer.length = 5 
compareOffset = 6 
compareLength = 


ArraylndexOutOfBoundsExceptio 
n is tlirown 




3 


compareOffset < 

compareBuffer.length = 5 
compareOffset = -1 
compareLength = 1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




4 


compareLength >compareBuffer.length 

compareBuffer.length = 5 
compareOffset = 
compareLength = 6 


Array 1 ndexOutOfBoundsExceptio 
n is thrown 




5 


CompareOffset + compareLength 

>compareBuf f er . length 
CompareBuffer.length = 5 
CompareOffset = 3 
CompareLength = 3 


Array 1 ndexOutOfBoundsExceptio 
n is thrown 




6 


compareLength < 

compareBuffer.length = 5 
compareOffset = 
compareLength = -1 


ArraylndexOutOfBoundsExceptio 
n is thrown 




7 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 5 

Text String TLV = OD 06 04 01 02 ... 05 








ProactiveResponseHandler.getTheHandierQ 








valueOffset ^ Text String Length 

tag = ODh, occurrence = 1 
valueOffset = 7 
compareBuffer.length = 15 
compareOffset = 
compareLength = 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




8 


valueOffset < 

valueOffset = -1 
compareBuffer.length = 15 

compareOffset = 
compareLength = 1 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 
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Id 


Description 


API Expectation 


APDU Expectation 


9 


compareLength > Text String length 

valueOffset = 
compareBuf fer . length = 15 
compareOf f set = 
compareLength = 7 


ToolkitException.OUT OF TLV 
BOUNDARIES is thrown 




10 


valueOffset + compareLength > Text String 
length 

valueOffset = 2 
compareBuf fer . length = 15 
compareOf f set = 
compareLength = 5 


ToolkitException.OUT OF TLV 
BOUNDARIES is tlirown 




11 


Invalid parameter 

Occurrence = 


ToolkitException.BAD_INPUT_PA 
RAMETER is tlirown 




12 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 









ProactlveResponseHandler.getTheHandierO 








Select a TLV (tag 02h) 








findAndCompareValueO 

tag = ODh 
occurrence = 2 


ToolkitException . U NAVAI LABLE_ 
ELEIVIENT is ttirown 






Call the getValueLengthO method 


ToolkitException . UNAVAI LABLE_ 
ELEIVIENT is thrown. 




13 


initialize compareBuffer 

\^ i- CO LJ J L C i_ — 

04 00 01 ... OF 









findAndCompareValueO 

tag = ODh, occurrence = 1 
valueOffset = 

compareOf f set = 
compareLength = 17 


Result is OOh 




14 


Verify current TLV 

GetValueLength 


Result is 17 




15 


initialize compareBuffer 

compareBuffer = 
04 00 01 ... 10 








Compare buffers with same parameters 


Result is -1 




16 


Initialize compareBuffer 

compareBuffer = 
03 00 01 ... OF 








Comnare buffers with samp parameters 

III i^cii ^7 1 1^71 w vv III 1 wm 1 1 V i^Qi m 1 cwi w 


Qpci lit Iq 4-1 




17 


initialize compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 Ofi 07 

U.J u/ 

08 09 OA OB OC 
55 55 55 55 55 








Compare buffers 

valueOffset = 2 
compareOf f set = 3 

L.. 1 i L kJ cii-CJ-ic^iiyUii — _LZ, 


Result is OOh 




18 


Initialize compareBuffer 

compareBuffer = 
55 55 55 02 01 
03 04 05 06 07 
08 09 OA OB OC 
55 55 55 55 55 








Compare buffers with same parameters 


Result is -1 
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Id 


Description 


API Expectation 


APDU Expectation 


19 


Initialize compareBuffer 

compareBuffer = 
55 55 55 01 02 
03 04 05 06 07 
08 09 OA OA OD 
55 55 55 55 55 








Compare buffers with same parameters 


Result is +1 




20 


Send a GET INPUT command 




GET INPUT Proactive 
command 




Terminal Response, with 2 Text String TLV 

OD 11 04 00 01 ... OF 

OD 06 00 11 22 33 44 55 








ProactiveResponseHandler.getTheHandlerQ 






- 


Initialize compareBuffer 

WlLLk^O. i- Ll -L J- i- — 

04 00 01 ... OF 









flndAndCompareValueQ 

uoy — uuii/ vj o o u J- J- 1; 1 1 o t; — -l 

valueOffset = 
compareOf f set = 
compareLength = 17 


Result is OOh 




21 


Initialize compareBuffer 

rMTi "Pi 3 r" o Ft 1 1 "F "F 1^ r" = 

00 11 22 33 44 55 









flndAndCompareValueQ 

F;^rT = OrMn r^r^r^ii"}"T*0"ni^o = / 

valueOffset = 
compareOf f set = 
compareLength = 6 


Result is OOh 




22 


Initialize compareBuffer 

cornp3irsBuffs IT = 
00 11 22 33 44 66 









flndAndCompareValueQ 

tag = ODh, occurrence = 2 
valueOffset = 

compareOf f set = 
compareLength = 6 


Result is -1 




23 


Send a GET INPUT command 




GET INPUT Proactive 
command 





Terminal Response, Text String length = 16 

Text String TLV = OD 11 04 00 01 ... OF 








ProactlveResponseHandler.getTheHandlerQ 








lnitifili7P f^nmrmi'ARiiffpi' 

IIIIIICIII^C 1 IIJCll CDU 1 1 CI 

CompareBuffer - 
04 00 01 ... OF 








Compare buffers (with tag BDh) 

tag = 8Dh, occurrence = 1 
valueOffset = 
compareOf f set = 
compareLength = 17 


Result is OOh 
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6.2.8.19.4 Test Coverage 



HRR niimhpr 


Tp^t cflQP niimhpr 


IM 1 


1 ^ 




14 

1 1" 




1"^ 17 ?n ?i 


N4 


15, 18, 22 


N5 


16, 19 


N6 


23 


PI 


1 


P2 


2, 3, 4, 5, 6 


P3 


7, 8, 9, 10 


P4 


11 


CI 


Does not apply for Proactive Response Handler 



6.2.9 Class ToolkitRegistry 

6.2.9.1 Method allocateTimer 

Test Area Reference: API_2_TKR_ATIM. 

6.2.9.1.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public byte allocateTimer ( ) throws ToolkitException 

6.2.9.1 .1 .1 Normal execution 

• CRRNl : the returned timer identifier shall be between 01 and 08 inclusive. 

• CRRN2: the returned timer identifier shall be different from a previously allocated but not released one. 

• CRRN3 : The SIM Toolkit Framework shall trigger the applet when receiving an ENVELOPE(TIMER 
EXPIRATION) command for the allocated timer. 

• CRRN4: A call to isEventSet() method for EVENT_TIMER_EXPIRATION should return true if the applet has 
at least one timer allocated. 

6.2.9.1 .1 .2 Parameters error 

No requirements. 

6.2.9.1 .1 .3 Context errors 

• CRRCl : Shall throw a ToolkitException with reason NO_TIMER_AVAILABLE if all the timers are allocated. 

• CRRC2: Shall throw a ToolkitException with reason NO_TIMER_AVAILABLE if the maximum number of 
timers have been allocated to this applet according to installation parameter. 

6.2.9.1.2 Test suite files 

Test Script: API_2_TKR_ATIM_l.scr 
Test Applet: API_2_TKR_ATIM_1 .Java 

API_2_TKR_ATIM_2.java 

API_2_TKR_ATIM_3.java 
Installation parameters: 
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For this test procedure the non- volatile memory of each instance is 200 (Hexa). 
The maximum timer parameter value is as follows for each applet: 

- applet 1 (API_2_TKR_ATIM_1): 8 timers. 

- applet 2 (API_2_TKR_ATIM_2): 4 timers. 

- applet 3 (API_2_TKR_ATIM_3): timer. 
Load Script; APl_2_TKR_ATIM_l.ldr 

The load script installs the 6 instances. 
Cleanup Script: API_2_TKR_ATIM_l.clr 
Parameter File: API_2_TKR_ATIM_1 .par 



6.2.9.1.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Allocates up to 8 timers 
(applet 1) 

8 * allocateTimer . 


No exception shall be thrown. 
Timer ID returned shall be between 
01 and 08 inclusive. It shall be 

different after each call. 




2 


Allocate timers more tlian the maximum 
(applet 1) 

The applet 1 allocates 1 more timer. 


Shall throw a ToolkitException with 
reason NO_TIMER_AVAILABLE. 




3 


Check applet is Triggered by 
ENVELOPE(TIMER_EXPIRATION) command 
(appletl) 

Send ENVELOPE (TIMER EXPIRATION) with all 
timers id (not in an increase order) . 

Calls releaseTimer (id) each time a timer 
expires . 


Shall trigger each time an 
ENVELOPE(TII\/IER EXPIRATION) 
is sent to the SIM, for Timer ID = 
'01 'to '08'. 




4 


Allocate up to 4 timers 
(applet 2) 

4 * allocateTimer . 


No exception shall be thrown. Each 
time, the returned timer identifier 

shall be between '01' and '08' 
inclusive. It shall be different after 
each call. 




5 


Allocate timers more than the maximum 
(applet 3) 

The applet 3 allocates 1 more timer. 


Shall throw a ToolkitException with 
reason NO_TIMER_AVAILABLE. 





6.2.9.1 .4 Test Coverage 



CRR number 


Test case number 


Ml 


1,4 


N2 


1,4 


N3 


3 


N4 


1 


CI 


2 


C2 


5 



6.2.9.2 Method changeMenuEntry 

Test Area Reference: API_2_TKR_CMETB_BSSBZBS. 
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6.2.9.2.1 



Conformance requirement: 



The method with following header shaU be compliant to its definition in the API. 



public void changeMenuEntry (byte id. 



throws 



byte[] menuEntry, 

short offset, 

short length, 

byte nextAction, 

boolean helpSupported, 

byte iconQualif ier , 

short iconldentif ier ) 

java . lang . NullPointerExcept ion, 

java . lang .Array IndexOutOfBoundsExcept ion, 

ToolkitException 



6.2.9.2.1.1 



Normal execution 



CRRNl: The SIM Toolkit Framework shall dynamically update the menu stored in the ME by issuing a SET UP 
MENU proactive command. The later will reflect the changes done for the entry. The SIM Toolkit Framework 
shall use the data of the EF sume file in order to build the SET UP MENU command. 

CRRN2: The default state of the changed menu entry is 'enabled'. 

CRRN3: a call to isEventSet() method on EVENT_MENU_SELECTION shall return true before and after the 
call. 

CRRN4: if helpSupported was true then a call to isEventSet() method on 
EVENT_MENU_SELECTION_HELP_REQUEST event shall return true. 

CRRN5: if helpSupported was true then after the completion of the SETUP MENU command, if an 
ENVELOPE(MENU_SELECTION_HELP_REQUEST) command is received by the SIM for this entry, then the 
SIM Toolkit framework shall trigger the applet. 

CRRN6: if help supported was true, the SIM Toolkit Framework shall issue a SETUP MENU connmand with 
connmand qualifier = '80'. 

CRRN7: if helpSupported was false and if no entries is supporting help then a call to isEventSet() method on 
EVENT_MENU_SELECTION_HELP_REQUEST event shall return false. 

CRRN8: if helpSupported was false and if no entries is supporting help then after the completion of the SETUP 
MENU command, if an ENVELOPE(MENU_SELECTION_HELP_REQUEST) command is received by the 
SIM, then the SIM Toolkit framework shall not trigger the applet. 

CRRN9: The SIM Toolkit Framework shall supply in the SET UP MENU command with the icon identifier 
provided in the icon identifier list within the item icon identifier list Simple TLV if all the applets registered to 
the EVENT_MENU_SELECTION provide it. 

CRRNIO: The SIM Toolkit Framework shall set in the SET UP MENU command with the Icon list qualifier 
transmitted to the ME as 'icon is not self explanatory' if one of the applet registered prefers this qualifier. 

CRRNl 1: If Next Action Indicator was different from '00', the SIM Toolkit Framework shall issue a SETUP 
MENU proactive command containing an Items Next Action Indicator simple TLV with the comprehension flag 
set to as defined in GSM 11.14 [4]. 

.2.1.2 Parameters error 

CRRPl: Shall throw java. lang. NuUPointerException - if menuEntry is null. 

CRRP2: ShaU throw java.lang.ArraylndexOutOfBoundsException - if offset would cause access outside array 
bounds. 

CRRP3: Shall throw java.lang.ArraylndexOutOfBoundsException - if length would cause access outside array 
bounds. 
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• CRRP4: Shall throw java.lang.ArraylndexOutOfBoundsException - if both offset and length would cause access 
outside array bounds. 



6.2.9.2.1.3 



Context errors 



• CRRCl : Shall throw a ToolldtException with MENU_ENTRY_NOT_FOUND reason if the Menu Identifier 
isn't associated to the calling applet instance. 

• CRRC2: Shall throw ALLOWED_LENGTH_EXCEEDED if the menu entry string is bigger than the allocated 
space. 

6.2.9.2.2 Test suite files 

Additional requirements for the GSM personalization: 
- content of EF sume shall be: 

- Title Alpha Identifier: "TOOLKIT TEST" 

Test Script: API_2_TKR_CMETB_BBSSBZBS_I.scr 
Test Applet: API_2_TKR_CMETB_BBSSBZBS_1 .Java 

- entry 'Ol'is "Initl". 

- entry '02'is "Init2". 
Installation parameter: 

Same as default applet but with: 

Maximum text length for a menu entry: 15 

- Maximum number of menu entries: 2 

- Position /Identifier for each menu entry: '017'01','027'02' 
Load Script: API_2_TKR_CMETB_BBSSBZBS_l.ldr 
Cleanup Script: API_2_TKR_CMETB_BBSSBZBS_l.ch- 
Parameter File: API_2_TKR_CMETB_BBSSBZBS_1 .par 

6.2.9.2.3 Test procedure 



Id 



Description 



API Expectation 



APDU Expectation 



1 



Applet changes the entry's title by menuEntry 
buffer, with a greater length than the initial 
length 

1- ChangeMenuEntry ( ) with parameters: 
Id = ' 02 ' 

MenuEntry = "UseAllBuf f er " 

Offset = 

Length = menuEntry . length 
NextAction = 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 0. 

2- isEventSet (EVENT_MENU_SELECTION) . 

3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) . 



1 - No exception sliall be thrown. 

2- shall return true. 

3- shall return false. 



The SIM shall issue a 
SETUP MENU proactive 
command which contains 
the new text for entry ID 
'02'. 
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Id 


Description 


API Expectation 


APDU Expectation 


2 


Changing the title with part of menuEntry 
buffer 

1- changeMenuEntry ( ) with parameters: 
Id = ' 01 ' 

MenuEntry = "UsePartOf Buf f er " 

Offset = 3 
Length = 12 
NextAction = 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 0. 

2- isEventSet (EVENT_MENU_SELECTION) . 

3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) 


1 - No exception shall be thrown. 

2- Shall return true. 

3- Shall return false. 


The SIM shall issue a 
SETUP MENU proactive 
command which contains 
the new text for entry ID 
'01'. 


3 


Length = 

1- ChangeMenuEntry ( ) for entry '01' and 
entry '02', with parameters: 

Id = '01'/'02' 
MenuEntry = "LengthEqualsO" 
Offset = 
Length = 
NextAction = 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 0. 

2- isEventSet (EVENT_MENU_SELECTION) . 

3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) . 


1 - No exception shall be thrown. 

2- Shall return true. 

3- shall return false. 


The SIM shall issue a 
SETUP MENU proactive 
command which contains 
for entry '01 'and entry '02', 
no text part. 


4 


Setting a next action indicator != 

1- ChangeMenuEntry () with parameters: 
Id = ' 02 ' 

MenuEntry = "NextActionlndic" 

Offset = 

Length = menuEntry . length 
NextAction = '10' (SETUP CALL) 

HelpSupported = false 
IconQualif ier = 
Iconldentif ier - 

2- isEventSet (EVENT_MENU_SELECTION) . 

3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) . 

4- ChangeMenuEntry with parameters: 
Id = ' 02 ' 

MenuEntry = "NextActionlndic" 

Cii^ <ii=^+- — n 
WJ_J_ocL — u 

Length = menuEntry . length 
NextAction = '10' (SETUP CALL) 
HelpSupported = true 
IconQualif ier = 
Iconldentif ier = 


1- No exception shall be thrown. 

2- Shall return true. 

3- Shall return false. 


The SIM shall issue a 
SETUP MENU proactive 
command which contains an 
Items Next Action Indicator 
list and which contains a 
command qualifier '80'. 
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5 



Description 



API Expectation 



APDU Expectation 



Checking applet is triggered by a 
MENU_SELECTION_HELP_REQUEST 

Send ENVELOPE (MENU_SELECTION_HELP_REQUEST) 
with Item Identifier = '02' 



Applet is trigged by a 
MENU_SELECTION_HELP_REQU 
EST and the Item Identifier is 02 



help supported=true 

1- changeMenuEntry ( ) with parameters: 
Id = ' 01 ' 

MenuEntry = "HelpSupported" 

Offset = 

Length = menuEntry . length 
Next Act ion = 
HelpSupported = true 
IconQualif ier = 
Iconldentif ier = 

2- isEventSet (EVENT_MENU_SELECTION) . 

3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) . 



1 - No exception shall be thrown. 

2- Shall return true. 

3- Shall return true. 



The SIIVI shall issue a 
SETUP MENU proactive 
command which contains a 
command qualifier '80'. 



Checking applet is triggered by a 
MENU_SELECTION_HELP_REQUEST 

Send ENVELOPE (MENU_SELECTION_HELP_REQUEST) 
with Item Identifier = '01' 



Applet is trigged by a 
MENU_SELECTION_HELP_REQU 
EST and the Item Identifier is 01 



Setting icons, help supported = false 

1- ChangeMenuEntry ( ) for entries 
'01', '02', with parameters: 

Id = ' 01 ' / ' 02 ' 

MenuEntry = " IconQualif ier " 

Offset = 

Length = menuEntry . length 
NextAction = 
HelpSupported = false 
IconQualif ier = '01' 
Iconldentif ier = '02' / '01' 

2- isEventSet (EVENT_MENU_SELECTION) . 

3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) . 



1 - No exception shall be thrown. 

2- Shall return true. 

3- Shall return false. 



The SIIVI shall issue a 
SETUP MENU proactive 
command which contains an 
Icon Identifier List. 



MenuEntry is disabled 

1- disableMenuEntry ( ' 01 ' ) . 

2- changeMenuEntry with parameters: 
Id = '01' 

MenuEntry = "EnableEntry " 
Offset = 

Length = menuEntry . length 
NextAction = 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 

3- isEventSet (EVENT_MENU_SELECTION) . 



isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) . 



1 - No exception shall be thrown. 

2- No exception shall be thrown. 

3- Shall return true. 

4- Shall return false. 



The SIM shall issue a 
SETUP MENU proactive 
command which contains 
the entry. Without Icon 
identifier List Simple TLV 
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Id 


Description 


API Expectation 


APDU Expectation 


10 


MenuEntry is null 

changeMenuEntry ( ) with : 
MenuEntry = NULL 


Shall throw 

java.lang.NullPolnterExceptlon. 




11 


Offset causes access outside array bounds 

Id = ' 01 ' 

MenuEntry = "Violation" 
Offset = menuEntry . length +1 
Length = 
NextAction = 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 




12 


Big Offset causes access outside array bounds 

Id = ' 01 ' 

MenuEntry = "Violation" 
Offset = 255 
Length = 1 
NextAction = 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 




13 


Offset < causes access outside array bounds 

Id = ' 01 ' 

MenuEntry = "Violation" 

Offset = -1 
Length = 1 
NextAction = 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 




14 


Length causes access outside array bounds 

Id = '01' 

MenuEntry = "Violation" 
Offset = 

Length = MenuEntry . length + 1 
NextAction = 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 0. 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 




15 


Lengtli < causes access outside array 
bounds 

Id = ' 01 ' 

MenuEntry = "Violation" 
Offset = 
Length = -1 
NextAction = 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 0. 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 




16 


Both offset and length causes access outside 
array bounds 

Id = '01' 

i^ItJll U.IljJ.1 1 Ly — V J-U X cl 1 LUJ.1 

Offset e [1, MenuEntry . length] 
Length = MenuEntry . length 
NextAction = 1 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 
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Id 


Description 


API Expectation 


APDU Expectation 


17 


Invalid ID used 

Id = ' 00 ' 

MenuEntry = contains text, != null 

Offset = 

Length = menuEntry . length < 16 
NextAction = 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 


Shall throw a ToolkitException with 
MENU_ENTRY_NOT_FOUND 
reason code. 




18 


ID isn't allocated to a menu entry of this applet 
instance 

Id = 'OA' 

MenuEntry = contains text, != null 
Offset = 

Length = menuEntry . length < 16 
NextAction = 

HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 


Shall throw a ToolkitException with 
reason code: 

MENU_ENTRY_NOT_FOUND. 




19 


The text is bigger than the allocated space 

Id = '02' 

MenuEntry = contains text, != null 
Offset = 

Length = menuEntry . length > 15 
NextAction = 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 


Shall throw a ToolkitException with 
reason code: 

ALLOWED_LENGTH_EXCEEDED. 




20 


With a smaller text length than the initial length 

1. changeMenuEntry ( ) with parameters: 
Id = ' 02 ' 

MenuEntry = "Init" 
Offset = 

Length = menuEntry . length 
NextAction = 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 

2 . isEventSet (EVENT_MENU_SELECTION) 
3. 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) 


1 . No exception shall be thrown. 

2. Shall return true. 

3. Shall return false. 


The SIIVI shall Issue a 
SETUP MENU proactive 

command which contains 
the new text for entry ID 
'02'. 
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6.2.9.2.4 Test Coverage 
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6.2.9.3 Method clearEvent 

Test Area Reference: API_2_TKR_CEVTB. 
6.2.9.3.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void clearEvent (byte event) 

throws ToolkitException 

6.2.9.3. 1 . 1 Normal execution 

• CRRNl : A call to isEventSet() method for a cleared event should return false after a call to clearEvent. 

• CRRN2:The SIM Toolkit Framework shall not trigger the applet on the occurrence of the cleared event anymore. 

• CRRN3 : if event was EVENT_CALL_CONTROL_B Y_SIM and after the call, no applet is registered to it, The 
SIM Toolkit Framework shall allow an applet to register to this event. 

• CRRN4: if event was EVENT_CALL_CONTROL_B Y_SIM and one applet is still registered to these event. The 
SIM Toolkit Framework shall not allow an applet to register to this event. 

• CRRN5 : if event was EVENT_MO_SHORT_MESSAGE_CONTROL_B Y_SIM and after the call, no applet is 
registered to it. The SIM Toolkit Framework shall allow an applet to register to this event. 

• CRRN6: if event was EVENT_MO_SHORT_MESSAGE_CONTROL_B Y_SIM and one applet is still 
registered to these event. The SIM Toolkit Framework shall not allow an applet to set this event. 

6.2.9.3. 1 .2 Parameters error 

• CRRP 1 : Shall throw a Toolkit Exception with reason EVENT_NOT_ALLOWED if event was 
EVENT_MENU_SELECTION. 

• CRRP2: Shall throw a Toolkit Exception with reason EVENT_NOT_ALLOWED if event was 
EVENT_MENU_SELECTION_HELP_REQUEST. 

• CRRP3 : Shall throw a Toolkit Exception with reason EVENT_NOT_ALLOWED if event was 
EVENT_TIMER_EXPIRATION. 

• CRRP4: Shall throw a Toolkit Exception with reason EVENT_NOT_ALLOWED if event was 
EVENT_STATUS_COMMAND. 
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6.2.9.3.1.3 

No requirements. 



Context errors 



6.2.9.3.2 

Test Script: 
Test Applet: 



Test suite files 

API_2_TKR_CEVTB_1 .scr 
API_2_TKR_CEVTB_1 .java 



As default but applet registers to an event list which contains all defined events in GSM 03.19 [7] excepted 
those that aren't allowed or supported by setEvent(). 



Load Script: 
Cleanup script: 
Parameter File: 



API_2_TKR_CEVTB_1 .Idr 
API_2_TKR_CEVTB_1 .clr 
API_2_TKR_CEVTB_1 .par 



6.2.9.3.3 



Test procedure 



Id 



Description 



API Expectation 



APDU Expectation 



Clear ALLOWED unregistered events 

For events ranging from 1 to 127 excepted 
those that aren't allowed 
( EVENT_MENU_SE LE CT I ON , 
EVENT_MENU_SELECTION_HELP_REQUEST, 
EVENT_T IMER_EXP I RAT I ON , 
EVENT_STATUS_COMMAND) , 
the applet calls: 

1- clearEventO method 

2- isEventSetO method 



1 - No exception is tlirown eacli 
time. 

2- Shall return false each time. 



Clear registered events 

1- For each ALLOWED and SUPPORTED events, 
the applet calls setEventO method. 

2- For events ranging from 1 to 127 
excepted those that aren't allowed, the 
applet calls: 

2.1- clearEventO method 

2.2- isEventSetO method 



1 - No exception shall be thrown. 

2.1- No exception shall be thrown. 

2.2- Shall return false. 



Clearing NOT ALLOWED events 

For each event among: 
EVENT_MENU_SELECTION, 

EVENT_MENU_SELECTION_HELP_REQUEST, 

EVENT_TIMER_EXPIRATION, 

EVENT_STATUS_COMMAND 

1- The applet calls clearEvent (event) 
method. 



1- Each time, clearEvent shall 
throw a Toolkit Exception with 
reason EVENT NOT ALLOWED. 



Checking applet Isn't triggered by an 
ENVELOPE(SMS-PP DOWNLOAD) command 

1 - reset and initialize the card 

2 - An ENVELOPE (SMS-PP DOWNLOAD) is sent 
with a TAR referencing applet. 



Applet is not trigged by an 
ENVELOPE(SMS-PP 
DOWNLOAD) command 
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6.2.9.4 Method disableMenuEntry 

Test Area Reference: API_2_TKR_DMETB. 

6.2.9.4.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void disableMenuEntry (byte id) 
throws ToolkitException 

6.2.9.4. 1 . 1 Normal execution 

• CRRNl : A call to isEventSet() method on EVENT_MENU_SELECTION shall return the same result before and 
after the call to disableMenuEntry() method. 

• CRRN2: A call to isEventSet() method on EVENT_MENU_SELECTION_HELP_REQUEST shall return the 
same result before and after the call to disableMenuEntryO method. 

• CRRN3: After invocation of this method the SIM Toolkit Framework shall dynamically update the menu stored 
in the ME . 

• CRRN4: After invocation of this method, if there is no more enabled menu entries then the SIM Toolkit 
framework shall issue a SETUP MENU proactive command containing Item Data Object for Item 1 TLV with a 
length of zero and no value part. 

6.2.9.4.1.2 Parameters error 

No requirements. 

6.2.9.4. 1 .3 Context errors 

• CRRCl : shall throw a ToolkitException with reason = ENTRY_NOT_FOUND if the menu entry doesn't exist 
for this applet. 

6.2.9.4.2 Test suite files 

Additional requirements for the GSM personalization: 
content of EF sume shall be: 

- Title Alpha Identifier: "TOOLKIT TEST" 

Test Script: API_2_TKR_DMETB_l.scr 
Test Applet: API_2_TKR_DMETB_1 .Java 
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Installation parameter: 

Same as default applet but with: 

- Maximum text length for a menu entry: 

- Maximum number of menu entries: 

- Position / Identifier for each menu entry: 
Load Script; API_2_TKR_DMETB_l.ldr 
Cleanup script: API_2_TKR_DMETB_ 1 .ch 
Parameter File: API_2_TKR_DMETB_1 .par 



15 
2 

'Ol'/'Or, '027'02' 



6.2.9.4.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Check the menu state before 
disabling a previously enabled entry 
not registered to 
EVENT_MENU_SELECTION_HELP_REQUEST 

1- reset and initialize the card 

2- isEventSet (EVENT_MENU_SELECTION) 

3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) 


1- Shall return true 

0- Chilli roti irn fslco 
^ Ollctll ic^lUliI Idlbc; 


1- The SIM shall issue a 
SET UP MENU proactive 
command with entry '01' 
and '02'. 


2 


Check the menu state after 
disabling a previously enabled entry 
not registered to 
EVENT_MENU_SELECTION_HELP_REQUEST 








1- disableMenuEntry ( ' 01 ' ) 

2- isEventSet (EVENT_MENU_SELECTION) 

3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 

EQUEST) 


1 - No exception shall be thrown. 

^ Ollctll IcLUIil lIUc. 

3- Shall return false. 


3- The SIM shall issue a 
SET UP MENU proactive 
command with entry '02' 

only. 


3 


Check the menu before 
disabling a previously enabled entry 
registered to 
EVENT_MENU_SELECTION_HELP_REQUEST 








1- change Menu Entry '02' to indicate 
help supported 

2- IsEventSet (EVENT_MENU_SELECTION) 
3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) 


2- Shall return true 

3- Shall return true 


3- The SIM shall issue a 
SET UP MENU proactive 
command with entry '02', 
indicating help supported. 


4 


Check the menu after 
disabling a previously enabled entry 
registered to 
EVENT_MENU_SELECTiON_HELP_REQUEST 








1- disableMenuEntry (' 02 ' ) 

2- isEventSet (EVENT_MENU_SELECTION) 
3- 

isEvent Set ( EVENT_MENU_SELECT ION_HELP_R 
EQUEST) 


1 - No exception shall be thrown. 

2- Shall return true. 

3- Shall return true. 


3- The SIM shall issue a 
SET UP MENU proactive 
command with 1 st Item TLV 
with a length of 0. 


5 


Disabling invalid entries 

For ID ranging from '00' to 'FF' except 
'01' and '02', the applet calls 
disableMenuEntry (ID) method. 


Each time a Toolkit Exception with 
MENU_ENTRY_NOT_FOUND 
reason code shall be thrown. 





ETSI 



3GPP TS 11 .1 3 version 8.2.1 Release 1 999 242 ETSI TS 1 01 955 V8.2.1 (2003-04) 

6.2.9.4.4 Test Coverage 



CRR number 


Test case number 


N1 


1, 2, 3, 4 


N2 


1,2, 3,4 


N3 


2, 4 


N4 


4 


C1 


5 



6.2.9.5 Method enableMenuEntry 

Test Area Reference: API_2_TKR_EMETB. 

6.2.9.5.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public void enableMenuEntry (byte id) 
throws ToolkitException 

6.2.9.5. 1 . 1 Normal execution 

• CRRN 1 : A call to isEventSet() method on E VENT_MENU_SELECTION shall return the same result before and 
after the call to enableMenuEntry() method. 

• CRRN2: A call to isEventSet() method on EVENT_MENU_SELECTION_HELP_REQUEST shall return the 
same result before and after the call to enableMenuEntryO method. 

• CRRN3:The SIM Toolkit Framework shall dynamically issue a SETUP MENU proactive command which does 
contain an ITEM SIMPLE TLV object for this entry. 

6.2.9.5. 1 .2 Parameters error 

No requirements. 

6.2.9.5.1.3 Context errors 

• CRRC 1 : shall throw a ToolkitException with reason = MENU_ENTRY_NOT_FOUND if the menu entry 
doesn't exist for this applet. 

6.2.9.5.2 Test suite files 

Additional requirements for the GSM personalization: 
- content of EE sume shall be: 

- Title Alpha Identifier: "TOOLKIT TEST" 

Test Script: API_2_TKR_EMETB_l.scr 
Test Applet: API_2_TKR_EMETB_l.java 
Installation parameter: 

Same as default applet but with: 

- Maximum text length for a menu entry: 15 

- Maximum number of menu entries: 2 

- Position /Identifier for each menu entry: 'Ol'/'Ol', '027'02' 
Load Script: API_2_TKR_EMETB_l.ldr 
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Cleanup script: 
Parameter File: 

6.2.9.5.3 



API_2_TKR_EMETB_1 .clr 
API_2_TKR_EMETB_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Check menu state before 
enabling a previously disabled entry 
not registered to 
EVENT_MENU_SELECTION_HELP_REQUEST 

1- isEventSet (EVENT_MENU_SELECTION) 

2- 

isEventSet (EVENT MENU SELECTION HELP R 
EQUEST) 

3- disableMenuEntry ( ' 01 ' ) 


1- Shall return true 

2- Shall return false 

3- No exception shall be thrown. 


3- The SIM shall Issue a 
SET UP MENU proactive 
command with entry '02' 
only. 


2 


Check menu state after 
enabling a previously disabled entry 
not registered to 
EVENT_MENU_SELECTION_HELP_REQUEST 

1- enableMenuEntry ( ' 01 ' ) 

2- isEventSet (EVENT_MENU_SELECTION) 

3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) 


1- No exception shall be thrown. 

2- Shall return true. 

3- Shall return false. 


3- The SIM shall issue a 
SET UP MENU proactive 
command with entry '01' 
and '02'. 


3 


Check menu state before 
enabling a previously enabled entry 
registered to 
EVENT_MENU_SELECTION_HELP_REQUEST 

1- change Menu Entry '02' to indicate 
help supported 

2- isEventSet (EVENT_MENU_SELECTION) 

3- 

isEventSet (EVENT MENU SELECTION HELP R 
EQUEST) 

4- disableMenuEntry (' 02 ' ) 


2- Shall return true 

3- Shall return true 

4- No exception shall be thrown 


4- The SIM shall issue a 
SET UP MENU proactive 
command with entry '01'. 
The help information 
available flag. is not verified 


4 


Check menu state after 
enabling a previously enabled entry 

EVENT_MENU_SELECTION_HELP_REQUEST 

1- enableMenuEntry ( ' 02 ' ) . 

2- isEventSet (EVENT_MENU_SELECTION) 

3- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 

EQUEST) 


1 - No exception shall be thrown. 

2- Shall return true. 

3- Shall return true. 


3- The SIM shall issue a 
SET UP MENU proactive 
command with entries '01' 
and '02' indicating help 

supported. 


5 


Enabling invalid entries 

For ID ranging from '00' to 'FF' except 
'01' and '02', the applet calls 
enableMenuEntry (ID) method. 


Each time a Toolkit Exception with 
MENU_ENTRY_NOT_FOUND 
reason code shall be thrown. 





6.2.9.5.4 Test Coverage 



CRR number 


Test case number 


N1 


1 2, 3, 4 


N2 


1, 2, 3, 4 


N3 


1, 2, 3, 4 


01 


5 
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6.2.9.6 Method getEntry 

Test Area Reference: API_2_TKR_GETY. 
6.2.9.6.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public static ToolkitRegistry getEntry () 
throws ToolkitException 

6.2.9.6.1.1 Normal execution 

• CRRNl: returns a reference to the applet ToolkitRegistry object of the calling applet. 

• CRRN2: Each successive call to getEntry() method shall return the same object. 



6.2.9.6.1.2 

No requirements. 

6.2.9.6.1.3 

No requirements. 

6.2.9.6.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup script: 
Parameter File: 

6.2.9.6.3 



Parameters error 
Context errors 
Test suite files 

API_2_TKR_GETY_1 .scr 
API_2_TKR_GETY_1 .java 
API_2_TKR_GETY_1 .Idr 
API_2_TKR_GETY_1 .ch 
API_2_TKR_GETY_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Installation 

In the constructor, the applet instance 
calls the getEntry () method. 


Returns a not null ToolkitRegistry 
instance. 




2 


Check it returns the same entry 

The applet calls the getEntry () method 
again . 


Returns the same ToolkitRegistry 
Instance as for test case 1 . 





6.2.9.6.4 Test Coverage 



CRR number 


Test case number 


N1 


1 


N2 


2 



6.2.9.7 Method getPolllnterval 

Test Area Reference: API_2_TKR_GPOL. 
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6.2.9.7.1 Conformance requirement 

The method with following header shaU be compliant to its definition in the API. 

public short getPollInterval ( ) 



6.2.9.7.1.1 



Normal execution 



• CRRNl: shall return a value between 1 and 15300 if applet is registered to EVENT_STATUS_COMMAND 
event. 

• CRRN2: shall return POLL_NO_DURATION value (0) if the toolkit applet is not registered to 
EVENT STATUS COMMAND event. 



6.2.9.7.1.2 

No requirements. 

6.2.9.7.1.3 

No requirements. 

6.2.9.7.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup script: 
Parameter File: 

6.2.9.7.3 



Parameters error 
Context errors 
Test suite files 

API_2_TKR_GPOL_l .scr 
API_2_TKR_GPOL_l .Java 
API_2_TKR_GPOL_l .Idr 

API_2_TKR_GPOL_l .ch 
API_2_TKR_GPOL_l .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Applet Isn't registered to 
EVENT_STATUS_COMMAND 

getPollInterval ( ) . 


Shall return 0. 




2 


Requesting max duration 

1- requestPollInterval (15300) 

2- Reset and initialize the card 

3- getPollInterval 


1 - No exception shall be thrown. 

3- Shall return a value between 1 
and 15300. 




3 


Requesting System Duration 

requestPollInterval (POLL_SYSTEM_DURATI 

ON) 

2- Reset and initialize the card 

3- getPollInterval . 


1 - No exception shall be thrown. 
3- Shall return a value between 1 
and 15300. 
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Id 


Description 


API Expectation 


APDU Expectation 


4 


Requesting no Duration 

1- requestPollInterval {POLL_NO_DURATION) 

2- Reset and initialize the card 

3- getPollInterval . 


1 - No exception shall be thrown. 
3- Shall return 0. 





6.2.9.7.4 Test Coverage 



CRR number 


Test case number 


N1 


2, 3 


N2 


1,4 



6.2.9.8 Method initMenuEntry 

Test Area Reference: API_2_TKR_IMET_BSSBZBS. 
6.2.9.8.1 Conformance requirement: 

The method with following header shall be compliant to its definition in the API. 

public byte InitMenuEntry (byte [ ] menuEntry, 
short offset, 
short length, 
byte nextAction, 
boolean helpSupported, 
byte IconQualif ier , 
short iconldentif ier ) 
throws java . lang . NullPointerExcept ion, 

java . lang . Array IndexOutOf BoundsExcept ion. 
Toolkit Except ion 



6.2.9.8.1.1 Normal execution 

• CRRNl: The SIM Toolkit Framework shall automatically update the menu stored in the ME by issuing a 
SETUP MENU proactive command. The later will reflect the changes done for the entry. The SIM Toolkit 
Framework shall use the data of the EE sume file in order to build the SET UP MENU command. 

• CRRN2: a call to isEventSet() method on EVENT_MENU_SELECTION shall return true after the l" successful 
call (without an exception). 

• CRRN3: if helpSupported was true then a following call to isEventSet() method on 
EVENT_MENU_SELECTION_HELP_REQUEST event shall return true . 

• CRRN4: if helpSupported was true then after the completion of the SETUP MENU command, if an 
ENVELOPE(MENU_SELECTION_HELP_REQUEST) command is received by the SIM for this entry, then the 
SIM Toolkit framework shall trigger the applet. 

• CRRN5: if help supported was true, the SIM Toolkit Framework shall issue a SETUP MENU command with 
command qualifier = '80'. 

• CRRN6: if helpSupported was false and there isn't any menu entry supporting help then a call to isEventSet() 
method on EVENT_MENU_SELECTION_HELP_REQUEST event shall return false. 

• CRRN7: The SIM Toolkit Framework shall supply in the SET UP MENU command with the icon identifier 
provided in the icon identifier list within the item icon identifier list Simple TLV if all the applets registered to 
the EVENT_MENU_SELECTION provide it. 

• CRRN8: The SIM Toolkit Framework shall set in the SET UP MENU command with the Icon list qualifier 
transmitted to the ME as 'icon is not self explanatory' if one of the applet registered prefers this qualifier. 
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• CRRN9: If Next Action Indicator was different from '00', the SIM Toolkit Framework shall issue a SETUP 
MENU proactive command containing an Items Next Action Indicator simple TLV with the comprehension flag 
set to 0. 

• CRRNIO: After the completion of the SETUP MENU command, if an ENVELOPE (MENU_SELECTION) 
command is received by the SIM for this identifier, then the SIM Toolkit framework shall trigger the applet. 

6.2.9.8.1.2 Parameters error 

• CRRPl: Shall throw java.lang.NuUPointerException - if menuEntry is null. 

• CRRP2: Shall throw java.lang.ArraylndexOutOfBoundsException - if offset would cause access outside array 
bounds. 

• CRRP3: Shall throw java.lang.ArraylndexOutOfBoundsException - if length would cause access outside array 
bounds. 

• CRRP4:Shall throw java.lang.ArraylndexOutOfBoundsException - if both offset and length would cause access 
outside array bounds. 

6.2.9.8.1.3 Context errors 

• CRRC 1 : Shall throw ALLOWED_LENGTH_EXCEEDED if the menu entry string is bigger than the allocated 
space. 

• CRRC2: Shall throw REGISTRY_ERROR if the menu entry cannot be initialized (e.g. no more item data in 
applet loading parameter). 

6.2.9.8.2 Test suite files 

Additional requirements for the GSM personalization: 
- content of EE sume shall be: 

- Title Alpha Identifier: "TOOLKIT TEST" 

- Test case trigger: 1- Applet instantiation 

2- Menu selection 

3- Menu selection Help Supported 
Test Script: API_2_TKR_IMET_BSSBZBS_l.scr 

Test Applet: API_2_TKR_IMET_BSSBZBS_1 .java 

Installation parameter: 

Same as default applet but with: 

- Maximum text length for a menu entry: 15 

- Maximum number of menu entries: 6 

- Position / Identifier for each menu entry: 'Ol'/'Ol', '02'/'02', '03'/'03', '04'/'04', '05'/'05', and '06'/'06' 
Load Script: API_2_TKR_lMET_BSSBZBS_l.ldr 

Cleanup script: API_2_TKR_IMET_BSSBZBS_l.clr 
Parameter File: API_2_TKR_IMET_BSSBZBS_1 .par 
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6.2.9.8.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


NULL as parameter to menuEntry 

MenuEntry = NULL 


Shall throw a 

java.lang.NullPointerException. 




2 


Offset > menuEntry.length 

MenuEntry = "ToolkitTest " 
Offset = 12 
Length = 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 




3 


Offset < 

MenuEntry = "ToolkitTest" 

Offset = -1 
Length = 11 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 




4 


Offset = 255 

MenuEntry = "ToolkitTest" 
Offset = 255 
Length = 11 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 




5 


Length = menuEntry.length+l 

MenuEntry = "ToolkitTest" 
Offset = 
Length = 12 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 




6 


Length) < 

MenuEntry = "ToolkitTest" 
Offset = 
Length = -1 


onaii inrow 

java.lang.ArraylndexOutOfBoundsE 
xception. 




7 


Offset + length > menuEntry.length 

MenuEntry = "ToolkitTest" 
of f c;et = 11 
Length = 1 


Shall throw 

java.lang.ArraylndexOutOfBoundsE 
xception. 




8 


MenuEntry.length > size allocated at loading 
for each menu entry 

MenuEntry = "ToolkitTest impossible" 
Offset = 
Length = 16 


ALLOWED_LENGTH_EXCEEDED 
ToolkitException is thrown. 




9 


Successful call, 
menuEntry is the whole buffer 

1- initMenuEntry ( ) 

MenuEntry = "TOOLKIT TEST 1" 
Offset = 
Length = 14 
NextAction = ' 00 ' 
HelpSupported = false 
IconQualif ier = '00' 
Iconldentif ier = 

2- isEventSet (EVENT_MENU_SELECTION) 


1 - No exception shall be thrown, 
Shall return ID '01'. 

2- Shall return true. 




10 


Successful call, 
menuEntry part of a buffer 

1- initMenuEntry ( ) 

MenuEntry = "1234567TOOLKIT TEST 2" 

Offset = 7 
Length =14 
NextAction = '00' 
HelpSupported = false 
IconQualif ier = '00' 
Iconldentif ier = 

2- 

isEventSet (EVENT_MENU_SELECTION_HELP_REQUE 
ST) 


1 - No exception shall be thrown. 
Shall return ID '02'. 
2- Shall return false. 
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Id 


Description 


API Expectation 


APDU Expectation 


11 


Successful call, 
menuEntry with help supported 

1- initMenuEntry ( ) 

MenuEntry = "TOOLKIT TEST 3" 

Offset = 
Length = 14 
NextAction = '00' 
HelpSupported ^ true 
IconQualif ier = '00' 
Iconldentif ier = 

2- 

isEventSet (EVENT_MENU_SELECTION_HELP_R 
EQUEST) 


1 - No exception shall be thrown, 
Shall return ID '03' 
2- Shall return true. 




12 


Successful call, 
menuEntry with an Icon 

MenuEntry = "TOOLKIT TEST 4" 

Offset = 

Length = 14 

NextAction = '00' 

HelpSupported = false 

IconQualif ier = '01' [icon not self 

explanatory] 

Iconldentif ier = 1 


1 - No exception shall be thrown. 
2- Shall return ID '04' 




13 


Successful call, 
menuEntry with a next action indication 

MenuEntry = "TOOLKIT TEST 5" 

Offset = 
Length =14 

NextAction = '24' [Select Item] 
HelpSupported = false 
IconQualif ier = '00' 
Iconldentif ier = 


1- No exception shall be thrown. 

2- Shall return ID '05' 




14 


Successful call, 
length = 

InitMenuEntry ( ) 

MenuEntry = "ToolkitTest " 
Offset = 
Length = 
NextAction = '00' 
HelpSupported = false 
I conQualif ier = '00' 
Iconldentif ier = 


No exception shall be thrown. Shall 
return ID '06'. 




15 


Initialize more entry than allocated at loading 

MenuEntry = "ToolkitTest" 
Offset = 
Length = 11 


REGISTRY_ERROR 
ToolkitException is thrown. 
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Id 


Description 


API Expectation 


APDU Expectation 


16 


Dynamic update of tlie menu stored by tlie me 

Fetch 




Card shall Send a 
SetUpMenu Proactive 
command: 

[CommandQualifier]=help 
supported 

[Alphald]="TOOLKIT TEST" 
[ltemld=1] = "TOOLKIT 
TEST 1 " 

[ltemld=2] = "TOOLKIT 
TEST 2" 

[ltemld=3] = "TOOLKIT 
TEST 3" 

[ltemld=4] = "TOOLKIT 
TEST 4" 

[ltemld=5] = "TOOLKIT 
TEST 5" 
[ltemld=6] = "" 
[ltemsNextAction]=0600000 
0002400 


17 


Clieck Applet is triggered by 
ENVELOPE(MENU_SELECTION) command 

Menu Entry ID = '01' 


Applet is trigged by an 
ENVELOPE(IVIENU_SELECTION) 
command & Menu Entry ID = '01' 




18 


Check Applet is triggered by 
ENVELOPE(MENU_SELECTION) command 

Menu Entry ID = '02' 


Applet is trigged by an 
ENVELOPE(IVIENU_SELECTION) 
command & Menu Entry ID = '02' 




19 


Check Applet is triggered by 
ENVELOPE(MENU_SELECTION) command 

Menu Entry ID = '03' 


Applet is trigged by an 
ENVELOPE(MENU_SELECTION) 
command & Menu Entry ID = '03' 




20 


Check Applet Is triggered by 
ENVELOPE(MENU_SELECTION) command 

Menu Entry ID = '04' 


Applet is trigged by an 
ENVELOPE(MENU_SELECTION) 
command & Menu Entry ID = '04' 




21 


Check Applet is triggered by 
ENVELOPE(MENU_SELECTION) command 

Menu Entry ID = '05' 


Applet is trigged by an 
ENVELOPE(MENU_SELECTION) 
command & Menu Entry ID = '05' 




22 


Check Applet is triggered by ENVELOPE 
(IV1ENU_SELECTI0N_HELP_REQUEST) 
command 

Menu Entry ID = '03' 


Applet is trigged by an 
ENVELOPE(MENU SELECTION 
HELP REQUEST) command & 
Menu Entry ID = '03' 




23 


Check Applet is triggered by 
ENVELOPE(MENU_SELECTION) command 

Menu Entry ID = '06' 


Applet is trigged by an 
ENVELOPE(MENU_SELECTION) 
command & Menu Entry ID = '06' 
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6.2.9.8.4 Test Coverage 



HRR niiinhpr 


Tp^t PfiQP niiiYihpr 

1 cot ^aoc iiuiiiud 


N1 

IM 1 


1 R 

1 D 




q 


■ NO 


1 1 


N4 


22 




11 16 




1 n 


N7 




N8 


12, 16 


N9 


13, 16 


N10 


9, 10, 11, 12, 13, 14, 17, 18, 19, 20, 21, 23 


P1 


1 


P2 


2, 3,4 


P3 


5,6 


P4 


7 


C1 


8 


C2 


14 



6.2.9.9 Method isEventSet 

Test Area Reference: API_2_TKR_IEVSB. 

6.2.9.9.1 Conformance requirement 

The method with following header shall be compliant to its definition in the API. 

public boolean isEventSet (byte event) 

6.2.9.9. 1 . 1 Normal execution 

• CRRNl : shall return true if the event is set in the Toolkit Registry for the applet. 

• CRRN2: shall return false if the event isn't set in the Toolkit Registry for the applet. 

6.2.9.9. 1 .2 Parameters error 

No requirements. 

6.2.9.9.1.3 Context errors 
No requirements. 

6.2.9.9.2 Test suite files 

Test Script: API_2_TKR_IEVSB_l.scr 
Test Applet: API_2_TKR_IEVSB_l.java 
Installation parameter: 

Same as default applet but with: 

- Maximum text length for a menu entry: 15 

- Maximum number of menu entries: 1 

- Position / Identifier for each menu entry: '0 1 7'0 1 ' 

- Maximum number of timers: 1 
Load Script: API_2_TKR_IEVSB_l.ldr 



ETSI 



3GPP TS 11.13 version 8.2.1 Release 1999 



252 



ETSI TS 101 955 V8.2.1 (2003-04) 



Cleanup script: 
Parameter File: 

6.2.9.9.3 



API_2_TKR_ffiVSB_l .clr 
API_2_TKR_IEVSB_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


-| 


Events aren't set 

Applet calls isEventSetO for each events 
ranging from 1 to 127 excepted 
EVENT_FORMATTED_SMS_PP_ENV and 

EVENT_MENU_SELECTION . 


Shall return false each time. 




2 


For EVENT_FORMATTED_SMS_PP_ENV 

isEventSet (EVENT_FORMATTED_SMS_PP_ENV) 


Shall return true. 




3 


For EVENT_MENU_SELECTION 

i sEvent Set (EVENT_MENU_SELECT ION ) 


Shall return true 




4 


After clearing 
EVENT_FORMATTED_SMS_PP_ENV 

1- clearEvent (EVENT_FORMATTED_SMS_PP_ENV) 
2- 

isEventSet (EVENT_FORMATTED_SMS_PP_ENV) 


1 - No exception shall be thrown. 
2- Shall return false. 




5 


Setting events 

1- For each SUPPORTED and ALLOWED events 
for setEventO, applet calls: 

1.1- setEventO method 

1.2- isEventSetO method. 


1.1- No exception shall be 
thrown. 

1 .2- Shall return true each time. 




6 


For 

EVENT_MENU_SELECTION_HELP_REQUEST 

1- isEventSet 

(EVENT_MENU_SELECTION_HELP_REQUEST) 

2- call changeMenuEntry with help 
supported 

3- isEventSet 

(EVENT MENU SELECTION HELP REQUEST) 


1- Shall return false. 
3- Shall return true 




7 


For EVENT_TIIVIER_EXPIRATION 

1- isEventSet (EVENT_TIMER_EXPIRATION) 

2- call allocateTimer ( ) 

3- isEventSet (EVENT_TIMER_EXPIRATION) 


1- Shall return false. 
3- Shall return true 




8 


For EVENT_STATUS_COMMAND 

1- IsEventSet (EVENT_STATUS_COMMAND) 

2- call 

requestPollInterval (POLL_SYSTEM_DURATION) 

3- isEventSet (EVENT_STATUS_COMMAND) 


1- Shall return false. 
3- Shall return true 





6.2.9.9.4 Test Coverage 



CRR number 


Test case number 


N1 


2, 3, 4, 5, 6, 7, 8 


N2 


1,5,6,7,8 
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6.2.9.10 



Method releaseTimer 



Test Area Reference: API_2_TKR_RTIMB. 



6.2.9.10.1 



Conformance requirement 



The method with following header shall be compliant to its definition in the API. 



public void releaseTimer (byte timerldentif ier) 
throws ToolkitException 



6.2.9.10.1.1 



Normal execution 



• CRRNl : if it was the last allocated timer for the applet then a following call to isEventSet() method for 

EVENT_TIMER_EXP1RATI0N should return false. 

• CRRN2: if applet has timers allocated then a call to isEventSet(EVENT_TIMER_EXPIRATION) shaU return 
true. 

• CRRN3: After invocation of the method the indicated timer shall be released and available for reallocation. 

• CRRN4: The applet is deregistered of the EVENT_TIMER_EXPIRATION for the indicated Timer Identifier. 

6.2.9.10.1.2 Parameters error 

• CRRPl : shall throw a ToolkitException with INVALID_TIMER_ID reason if the timer identifier isn't between 1 
and 8. 

6.2.9.10.1.3 Context errors 

• CRRC 1 : shall throw a ToolkitException with INVALID_TIMER_ID reason if the timer is valid but isn't 
allocated to this applet. 

6.2.9.10.2 Test suite files 

Test Script: API_2_TKR_RTIMB_l.scr 
Test Applet: API_2_TKR_RTIMB_1 .Java 

Installation parameter: 



As Default, except max timer which is set to 8. 



Load Script: 



API_2_TKR_RTIMB_1 .Idr 



Cleanup script: 



API_2_TKR_RT1MB_1 .ch 



Parameter File: 



API_2_TKR_RTIMB_1 .par 
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6.2.9.10.3 Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Releasing not allocated timers 

For each timer ID ranging from '00' to 
'FF', applet calls releaseXimer (ID) . 


Each time, method shall throw a 
ToolkitExceptlon with reason code 
INVALID_TIMERJD. 




2 


Releasing allocated timers 

1- 8 * allocateXimer . 

2- 7 * releaseXimer (id) . 

3- isEventSet (EVENX_XIMER_EXPIRAXION) 


1- No exception shall be thrown. 

2- Each time, no exception shall be 
thrown. 

3- Shall return true 




3 


Releasing invalid timer ID 

1— releaseXimer (' FF ' ) method 

2- isEventSet (EVENX_XIMER_EXPIRAXION) 


1 - Shall throw a ToolkitExceptlon 
with INVALID_TIMERJD reason 
code. 

2- Shall return true. 




4 


Releasing last timer 

1— releaseXimer ( last timer allocated) 

2- isEventSet (EVENX_XIMER_EXPIRAXION) 


1 - No exception shall be thrown. 
2- Shall return false. 







onecKiny we can aiiocaie iirners aiier iney 

have been released 

8 * allocateXimer . 


No exception shall be thrown. 




6 


Releasing all timers. 

For 1 to 8, releaseXimer (id) . 


No exception shall be thrown. 




7 


Checking applet isn't triggered by 

ENVELOPE (XIMER_EXPIRAXION) command 
Send ENVELOPE (XIMER_EXPIRAXION) 


Applet is not trigged by an 

ENVELOPE(TIMER_EXPIRATION) 

command 





6.2.9.10.4 Test Coverage 



CRR number 


Test case number 


N1 


4 


N2 


2, 3 


N3 


5, 6 


N4 


7 


P1 


1,3 


C1 


Framework 



6.2.9.11 Method requestPolllnterval 

Test Area Reference: API_2_TKR_RPOLS. 
6.2.9.1 1.1 Conformance requirement 

The method with following header shall be compliant to its definition in the APT 

public void requestPolllnterval (short duration) 
throws XoolkitException 
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• CRRNl : If duration is between 1 and 15 300 or equal to POLL_SYSTEM_DURATION, the applet registers to 
EVENT_STATUS_COMMAND. 

• CRRN2: If duration is POLL_NO_DURATION, the applet is deregistered from 
EVENT STATUS COMMAND. 



6.2.9.11.1.2 



Parameters error 



• CRRPl : the method should throw a ToolkitException with REGISTRY_ERROR reason if duration is > 15 300 
or is < -1 (POLL_SYSTEM_DURATION). 



6.2.9.11.1.3 

No Requirements. 

6.2.9.11.2 

Test Script: 
Test Applet: 
Load Script: 

Cleanup script: 
Parameter File: 

6.2.9.11.3 



Context errors 
Test suite files 

API_2_TKR_RPOLS_l .scr 
API_2_TKR_RPOLS_l .Java 
API_2_TKR_RPOLS_l .Idr 

AP1_2_TKR_RP0LS_1 .clr 
APl_2_TKR_RPOLS_l .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Requesting a value between 1 and 15300 s 

1- isEventSet (EVENT_STATUS_COMMMAND) 

2- requestPollInterval (duration) for 
boundaries values: 1, 255, 256, 15300. 

3- isEventSet (EVENT_STATUS_COMMAND) . 


1- Shall return false. 

2- No exception shall be thrown. 

3- Shall return true. 




2 


Check Applet is triggered by a STATUS 
command 

1- reset and card initialization 

2- Send STATUS command 


2- Applet is trigged by a STATUS 
command 




3 


Requesting POLL SYSTEM DURATION 

1- isEventSet (EVENT_STATUS_COMMMAND) . 
2- 

RequestPollInterval (POLL_SYSTEM_DURATI 

ON) . 

3- IsEventSet (EVENT_STATUS_COMMAND) . 


1- Shall return true. 

2- No exception shall be thrown. 

3- Shall return true. 




4 


Check Applet is triggered by a STATUS 
command 

1- reset and card initialization 

2- Send STATUS command 


2- Applet is trigged by a STATUS 
command 




5 


Requesting Invalid duration 

requestPolllnterval(duration) for following values: 
15301, 32767, -2, -32768 


Each time, a ToolkitException with 
REGISTRY_ERROR reason code, 
shall be thrown. 
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Id 


Description 


API Expectation 


APDU Expectation 


c 
D 


1- isEventSet (EVENT_STATUS_COMMMAND) 

2- requestPollInterval (POLL_NO_DURATION) 

3- isEventSet (EVENT_STATUS_COMMAND) 


1- Shall return true. 

2- No exception shall be thrown. 

3- Shall return false. 




7 


Check Applet isn't triggered by an STATUS 
command. 

1- reset and card initialization 

2- Send STATUS command 


2- Applet is not trigged by a 
STATUS command 





6.2.9.1 1 .4 Test Coverage 



CRR number 


Test case number 


N1 


1, 2, 3, 4 


N2 


6, 7 


P1 


5 



6.2.9.12 Method setEvent 

Test Area Reference: API_2_TKR_SEVTB. 
6.2.9.12.1 Conformance Requirement 

The method with following header shall be compliant to its definition in the API. 

public void setEvent (byte id) 

throws ToolkitException 

6.2.9.12.1.1 Normal execution 

• CRRNl : a following call to isEventSet() method with the same event id shall answer true for the applet. 

• CRRN2: the SIM Toolkit Framework shall trigger the applet if an occurrence of the set event happens. 

• CRRN3: this method shall accept all the events defined in GSM 0319 excepted: EVENT_MENU_SELECTION, 
EVENT_MENU_SELECTION_HELP_REQUEST,EVENT_TIMER_EXPIRATION, 
EVENT_STATUS_COMMAND. 

6.2.9.12.1.2 Parameters error 

• CRRP 1 : shall throw a ToolkitException with EVENT 

• CRRP2: shall throw a ToolkitException with EVENT 
EVENT_MENU_SELECTION. 

• CRRP3 : shall throw a ToolkitException with EVENT 
EVENT_MENU_SELECTION_HELP_REQUEST. 

• CRRP4: shall throw a ToolkitException with EVENT 
EVENT_TIMER_EXPIRATION. 

• CRRP5: shall throw a ToolkitException with EVENT 
EVENT_STATUS_COMMAND. 

6.2.9.12.1 .3 Context errors 

• CRRCl : shall throw a ToolkitException with EVENT_ALREADY_REGISTERED if event is 
EVENT_CALL_CONTROL_BY_SIM but another applet is already registered to it. 



.NOT_SUPPORTED reason if event is 0. 
NOT_ALLOWED reason if event is 

NOT_ALLOWED reason if event is 

NOT_ALLOWED reason if event is 

NOT_ALLOWED reason if event is 
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• CRRC2: shall throw a ToolkitException with EVENT_ALREADY_REGISTERED if event is 

EVENT_MO_SHORT_MESSAGE_CONTROL_B Y_SIM but another applet is already registered to it. 



6.2.9.12.2 

Test Script: 
Test Applet: 

Load Script: 

Cleanup script: 
Parameter File: 



Test suite files 

API_2_TKR_SEVTB_1 .scr 

API_2_TKR_SEVTB_1 .Java 

API_2_TKR_SEVTB_2.java 

API_2_TKR_SEVTB_1 .Idr 

The load script installs the 2 instances. 

API_2_TKR_SEVTB_1 .clr 

API_2_TKR_SEVTB_1 .par 



6.2.9.12.3 



Test Procedure 



Id 



Description 



API Expectation 



APDU Expectation 



Applet 1 is triggered by ENVELOPE(SMS_ 
PP_FORMATTED) command. 

Send ENVELOPE (SMS_PP_FORMATTED) 



Applet 1 shall be triggered 



Setting ALLOWED and SUPPORTED events 

1- For all events defined in GSM 0319 
(from 1 to 19) and allowed: 
EVENT_PROFILE_DOWNLOAD, 
EVENT_FORMATTED_SMS_PP_ENV, 
EVENT_FORMATTED_SMS_PP_UPD, 
EVENT_UNFORMATTED_SMS_PP_ENV, 
EVENT_UNFORMATTED_SMS_PP_UPD, 
EVENT_FORMATTED_SMS_CB, 
EVENT_UNFORMATTED_SMS_CB, 
EVENT_CALL_CONTROL_BY_SIM, 
EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM, 
EVENT_EVENT_DOWNLOAD_MT_CALL , 
EVENT_EVENT_DOWNLOAD_CALL_CONNECTED, 
EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED, 
EVENT_EVENT_DOWNLOAD_LOCATION_STATUS, 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY, 
EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABL 
E, 

EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 

EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION, 

EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION. 

1.1- clearEvent (event ) 

1.2- isEventSet (event ) 

1.3- setEvent (event) 

1.4- isEventSet (event ) 

1.5- clearEvent (event ) 



1.1- No exception shall be thrown. 

1 .2- Shall return false. 

1 .3- No exception shall be thrown. 

1 .4- Shall return true. 

1 .5- No exception shall be thrown. 



Event 



Call setEvent (0) 



Shall throw a ToolkitException with 
EVENT_NOT_SUPPORTED reason 
code. 



Setting EVENT_MENU_SELECTION 

Call setEvent (EVENT_MENU_SELECTION) 



Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code. 



ETSI 



3GPP TS 11 .1 3 version 8.2.1 Release 1 999 258 ETSI TS 1 01 955 V8.2.1 (2003-04) 



Id 


Description 


API Expectation 


APDU Expectation 


5 


Setting 

EVENT_IUIENU_SELECTION_HELP_REQUEST 

Call 

setEvent (EVENT_MEND_SELECTION_HELP_REQUES 
T) 


Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code. 




6 


Setting EVENT_TII\1ER_EXPIRATI0N 

Call setEvent {EVENT_TIMER_EXPIRATION) 


Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code. 




7 


Setting EVENT_STATUS_COIVIMAND 

Call setEvent (EVENT_STATUS_COMMAND) 


Shall throw a ToolkitException with 
EVENT_NOT_ALLOWED reason 
code. 




8 


Setting EVENT_CALL_CONTROL_BY_SII\/l 

Call setEvent (EVENT_CALL_CONTROL_BY_SIM) 


No Exception shall be thrown 




9 


Setting 

EVENT MO SHORT MESSAGE CONTROL B 
Y_SIM 

Call 

S et Event ( EVENT_MO_SHORT_ME S SAGE_CONTROL_B 
Y_SIM) 


No Exception shall be thrown 




1 u 


oncCK appiei IS iriggcreu uy an 
ENVELOPE(CALL_CONTROL_BY_SIM) 

Trigger the applet 


Applet is trigged by an 
ENVELOPE(CALL CONTROL BY 
SIM) 




1 1 


Check applet is triggered by an 
ENVELOPE(MO SHORT MESSAGE CONTRO 
L_BY_SIM) 

Trigger the Applet 


Applet is trigged by an 
ENVELOPE(MO SHORT MESSAG 
E_CONTROL_BY_SIM) 




12 


Applet 2 is triggered by ENVELOPE(SMS 
PP_DOWNLOAD) command. 

Trigger the applet 2 


Applet 2 is trigged by an 
ENVELOPE(SMS_ 
PP_DOWNLOAD) command 




13 


Applet 2 registers to 
CALL_CONTROL_BY_SIM 
but it is already assigned 

setEvent {EVENT_CALL_CONTROL_BY_SIM) 


Shall throw a ToolkitException with 
EVENT_ALREADY_REGISTERED 
reason code. 




14 


Applet 2 registers to 
MO_MESSAGE_CONTROL_BY SIM 
but It is already assigned 

setEvent (EVENT_MO_SHORT_MESSAGE_CONTROL_B 
Y_SIM) 


Shall throw a ToolkitException with 
EVENT_ALREADY_REGISTERED 
reason code. 





6.2.9.12.4 Test Coverage 



CRR number 


Test case number 


N1 


2 


N2 


1,8, 9, 10, 11, 12 


N3 


2, 4, 5, 6, 7 


PI 


3 


P2 


4 


P3 


5 


P4 


6 


P5 


7 


CI 


13 


C2 


14 



6.2.9.13 Method setEventList 

Test Area Reference: API_2_TKR_SEVL_BSS. 
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6.2.9.13.1 Conformance Requirement 

The method with following header shaU be compliant to its definition in the API. 

public void setEventList (byte [ ] eventList, 

short offset, 
short length) 
throws java . lang . NullPointerException, 

java . lang . Array IndexOutOf BoundsException, 
ToolkitException 

6.2.9.13.1.1 Normal execution 

• CRRNl: for aU events set successfully by this method, a call to isEventSet() method should return true. 

• CRRN2: the SIM Toolkit Framework shall trigger the applet if an occurrence of one of the successfully 
registered events happens. 

• CRRN3: this method shall accept all the events defined in GSM 0319 excepted: EVENT_MENU_SELECTION, 
EVENT_MENU_SELECTION_HELP_REQUEST,EVENT_TIMER_EXPIRATION, 
EVENT_STATUS_COMMAND. 

6.2.9.13.1.2 Parameters error 

• CRRPl : shall throw a java.lang.NulIPointerException if eventList is null. 

• CRRP2: shall throw a java.lang.ArraylndexOutOfBoimdsException if offset would cause access outside array 
boimds. 

• CRRP3: shall throw a java.lang.ArraylndexOutOfBoundsException if length would cause access outside array 
bounds. 

• CRRP4: shall throw a java.lang.ArraylndexOutOfBoimdsException if both offset and length would cause access 
outside array bounds. 

• CRRP5 : shall throw a ToolkitException with EVENT_NOT_SUPPORTED reason if event is 0. 

• CRRP6: shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if eventList contains 

EVENT_MENU_SELECTION. 

• CRRP7: shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if eventList contains 
EVENT_MENU_SELECTION_HELP_REQUEST. 

• CRRP8: shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if eventList contains 
EVENT_TIMER_EXPIRATION. 

• CRRP9 : shall throw a ToolkitException with EVENT_NOT_ALLOWED reason if eventList contains 
EVENT_STATUS_COMMAND. 

6.2.9.13.1.3 Context errors 

• CRRC 1 : shall throw a ToolkitException with EVENT_ALREADY_REGISTERED if eventList contains 
EVENT_CALL_CONTROL_BY_SIM but another applet is already registered to it. 

• CRRC2: shall throw a ToolkitException with EVENT_ALREAD Y_REGISTERED if eventList contains 
EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM but another applet is aheady registered to it. 

6.2.9.13.2 Test suite files 



Test Script: 


API. 


.2. 


.TKR. 


.SEVL. 


BSS. 


.l.scr 


Test Applet: 


API. 


.2. 


TKR. 


SEVL. 


BSS. 


.l.java 




API. 


.2. 


TKR. 


SEVL. 


BSS. 


.2 .java 
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Load Script: API_2_TKR_SEVL_BSS_l.ldr 

The load script installs the 2 instances. 
Cleanup script: API_2_TKR_SEVL_BSS_l.clr 
Parameter File: API_2_TKR_SEVL_BSS_1 .par 



6.2.9.13.3 



Test Procedure 



Id 



Description 



API Expectation 



APDU Expectation 



Applet 1 Registering all eventList buffer 

EventList = all allowed events defined in 
GSM 0319: 

EVENT_PROF I LE_DOWNLOAD , 

EVENT_FORMATTED_SMS_PP_ENV, 

EVENT_FORMATTED_SMS_PP_UPD , 

EVENT_UNFORMATTED_SMS_PP_ENV, 

EVENT_UNFORMATTED_SMS_PP_UPD , 

EVENT_FORMATTED_SMS_CB , 

EVENT_UNFORMATTED_SMS_CB , 

EVENT_CALL_CONTROL_BY_SIM, 

EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM, 

EVENT_EVENT_DOWNLOAD_MT_CALL, 

EVENT_EVENT_DOWNLOAD„CALL_CONNECTED, 

EVENT_EVENT_DOWNLOAD_CALL_D I SCONNECTED , 

EVENT_EVENT_DOWNLOAD_LOCATION_STATUS, 

EVENT_EVENT_DOWNLOAD_USER_ACTIVITY, 

EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 

, EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 

EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION, 

EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION. 

1- For each event in EventList 

clearEvent (event) 

2- setEventList (eventList) 
Offset = 

Length = eventList . lentgh 

3- For all events in eventList 

isEventSet (event) 

4- For each event in EventList 
clearEvent (event) 



1 - No exception shall be thrown. 

2- No exception shall be thrown. 

3- Each time shall return true. 

4- No exception shall be thrown. 



Registering part of eventList buffer 

EventList = all allowed events defined in 
GSM 0319 (see test case 1) . 

1- For each event in EventList 
clearEvent (event) 

2- setEventList (eventList, offset, 
length) 

Offset > 

Length = eventList . lentgh - offset 

3- For all events in eventList: 
isEventSet (event) 

4- For each event in EventList: 
clearEvent (event) 



1 - No exception shall be thrown. 

2- No exception shall be thrown. 

3- Each time shall return true for 
events ranging from offset to 
offset+length else shall return false. 

4- No exception shall be thrown. 



Null buffer 



EventList 



null 



Shall throw a 

java.lang.NullPointerException 
Exception 
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Id 


Description 


API Expectation 


APDU Expectation 


4 


Out of bounds offset 

offset = eventList . length 
Length = 1 


Shall throw a 

java.lang. Array IndexOutOf Bounds 
Exception 




5 


Out of bounds and big offset 

Offset = 255 
Length = 1 


Shall throw a 

lava lana ArravlndsxOutOfBounds 
Exception 




6 


Offset < 

offset = -1 
Length = 1 


Shall throw a 

java.lang. Array IndexOutOf Bounds 
Exception 




7 


Out of bounds length 

Offset = 

Length = eventList . length + 1 


Shall throw a 

java.lang. Array IndexOutOf Bounds 
Exception 




8 


Out of bounds and big length 

offset = 

Lenqth = 2 55 


Shall throw a 

lava lana ArravlndexOutOfBounds 

Exception 




9 


Length < 

Offset = 
Length = -1 


Shall throw a 

java.lang.ArraylndexOutOfBounds 
Exception 




10 


Out of bounds offset + Length 

Offset + length > eventList . length + 1 


Shall throw a 

iava lann ArravlnHpxOiitOfBniind^ 

JCI V d. idi lU ./^i Idyll i\.icyw^i_i L^^i i-J\J\A 1 lUO 

Exception 




11 


Event 

Call setEventList (eventList) with 
eventList indicating event 


Shall throw a ToolkitException with 
EVENT_NOT_SUPPORTED 
reason code. 




12 


EVENT_MENU_SELECTION 

Call setEventList (eventList) with 


Shall throw a ToolkitException with 
reason code 

EVENT_NOT_ALLOWED. 




13 


EVENT_MENU_SELECTION_HELP_REQUEST 

Call setEventList (eventList ) with 
eventList indica.ting 
EVENT_MENU„SELECTION_HELP_REQUEST 


Shall throw a ToolkitException with 
reason code 

EVENT_NOT_ALLOWED. 




14 


EVENT_TIIVIER_EXPIRATION 

Call setEventList (eventList) with 

C^VC^llL--l-i-LOL- _LliLJ._Lv^ClL--Lliy 

E VE N T_T I ME R_E XP I RAT I ON 


Shall throw a ToolkitException with 
reason code 

EVENT_NOT_ALLOWED. 




15 


EVENT_STATUS_COMMAND 

Call setEventList (eventList) with 
eventList indicating EVENT_STATUS_COMMAND 


Shall throw a ToolkitException with 
reason code 

EVENT_NOT_ALLOWED. 




16 


Setting EVENT_CALL_CONTROL_BY_SIM 

setEventList (List, 0, 2) with List 
containing 

EVENT CALL CONTROL BY SIM S 
h;v'LAi_XO_ShORi_XESSAGL_COAi'ROL_HY_S±:-: 


Shall not throw an exception 




17 


Check applet is triggered by an 
ENVELOPE(CALL_CONTROL_BY_Sliyi) 

Reset and initialize the card 
Trigger the applet 


Applet is trigged by an 
ENVELOPE(CALL CONTROL BY 
_SIM) 
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Id 


Description 


API Expectation 


APDU Expectation 


18 


Check applet is triggered by an 
ENVELOPE(MO SHORT MESSAGE CONTROL 

_BY_SIM) 

Trigger the applet 


Applet is trigged by an 
ENVELOPE(MO_SHORT_MESSA 
G E_CONTROL_B Y_S 1 M) 




19 


Applet 2 registers to CALL_CONTROL_BY_SIM 
but It Is already assigned 

setEventList (MonoEventList, 0, 1) with 
MonoEventList containing 
EVENT_CALL_CONTROL_BY_S IM 


Shall throw a ToolkitException with 
EVENT_ALREADY_REGISTERED 
reason code. 




20 


Applet 2 registers to 
MO_SHORT MESSAGE_CONTROL_BY_SIM 
but it is already assigned 
setEventList(IUIonoEventList,0,1) with 
MonoEventList containing 
EVENT MO SHORT MESSAGE CONTROL BY 
_SIM 


Shall throw a ToolkitException with 
EVENT_ALREADY_REGISTERED 
reason code. 





6.2.9.13.4 Test Coverage 



CRR number 


Test case number 


N1 


1,2 


N2 


16, 17, 18 


N3 


1,2, 11, 12, 13, 14, 15 


PI 


3 


P2 


4, 5, 6 


P3 


7, 8, 9 


P4 


10 


P5 


11 


P6 


12 


P7 


13 


P8 


14 


P9 


15 


CI 


19 


C2 


20 



6.2.10 Class ViewHandler 

It is not possible to test the methods provided by this class as it is declared 'abstract'; it will be done in the class 
inheriting it: EditHandler, EnvelopeHandler, ProactiveResponseHandler, ProactiveHandler. 

6.2.1 1 Class ToolkitException 
6.2.1 1 .1 Exception Constants 

Test Area Reference: API_2_TKE_CONS. 



6.2.1 1.1.1 Conformance requirement 

There is no API, only constants. 

6.2.11.1.1.1 Normal execution 

• CRRNl: The Constants of the class ToolkitException shall all have the same name and value defined in the 
GSM 03.19 [7]. 

6.2.1 1 .1 .1 .2 Parameters error 
No requirements. 
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6.2.11.1.2 
None. 

6.2.11.1.3 



Test suite files 



Test procedure 



The constants in Java are resolved at compilation time, therefore a runtime test is not useful. No test of constants will be 
performed. 

6.2.1 1 .2 Constructor ToolkitException 

Test Area Reference: API_2_TKE_COORS. 

6.2.1 1 .2.1 Conformance requirement: 

The constructor with following header shall compliant to its definition in the API. 

public ToolkitException ( short reason) 

6.2.1 1 .2.1 .1 Normal execution 

• CRRNl : Construct a ToolkitException instance with the specified reason. 



6.2.11.2.1.2 

No requirements. 

6.2.11.2.1.3 

No requirements. 

6.2.11.2.2 



Parameters error 



Context errors 



Test suite files 



No additional requirements for the GSM personahzation: 



Test Script: 


API. 


.2. 


TKE. 


.COORS. 


.l.scr 


Test Applet: 


API. 


.2. 


TKE. 


.COORS. 


.l.java 


Load Script: 


API. 


.2. 


TKE. 


.COORS. 


.Lldr 


Cleanup script: 


API. 


.2. 


TKE. 


.COORS. 


.l.ch 


Parameter File: 


API. 


.2. 


TKE. 


.COORS. 


.l.par 



6.2.11.2.3 



Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


reason = (short) 1 9 


ToolkitException.getReasonO = (short)19 




6.2.11.2.4 


Test Coverage 







CRR number 


Test case number 


N1 


1 
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6.2.11.3 Method throwit 

Test Area Reference: API_2_TKE_THITS. 

6.2.1 1 .3.1 Conformance requirement 

The method with following header shall compliant to its definition in the API. 

public static void throwit { short reason) 
throws ToolkitException 

6.2.11.3.1.1 Normal execution 

• CRRNl: Throws the JCRE instance of the ToolkitException class with the specified reason. 

• CRRN2: extends javacard.framework.CardRuntimeException 



6.2.11.3.1.2 

No requirements. 

6.2.11.3.1.3 

No requirements. 

6.2.11.3.2 



Parameters error 



Context errors 



Test suite files 



No additional requirements for the GSM personalization: 



Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.2.11.3.3 



API_2_TKE_THITS_1 . scr 
API_2_TKE_THITS_1 .j ava 
API_2_TKE_THITS_1 .Idr 
API_2_TKE_THITS_1 .clr 
API_2_TKE_THITS_1 .par 

Test procedure 



Id 


Description 


API Expectation 


APDU Expectation 


1 


Throws the JCRE instance of ToolkitException 
with the specified reason 


Reason = 




2 


Throws the JCRE instance of ToolkitException 
with the specified reason 


Reason = 1 




3 


Throws the JCRE instance of ToolkitException 
with the specified reason 


Reason = 1 5 




4 


ToolkitException extends 
javacard.framework.CardRuntimeException 


Reason = 




5 


ToolkitException extends 
javacard.framework.CardRuntimeException 


Reason = 1 




6 


ToolkitException extends 
javacard.framework.CardRuntimeException 


Reason = 1 5 





6.2.11.3.4 Test Coverage 



CRR number 


Test case number 


N1 


1, 2, 3 


N2 


4, 5, 6 
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6.3 SIM Toolkit Framework 
6.3.1 Minimum Handler Availability 

This test area tests the rules that define the minimum requirements for the availability of the system handlers. 

6.3.1.1 ProactiveHandler 

Test Area Reference: FWK_MHA_PAHD. 
6.3.1.1.1 Conformance Requirement 

6.3.1.1.1.1 Normal Execution 

• CRRNl: If a proactive session is not ongoing the ProactiveHandler is available from the invocation to the 
termination of the processToolkit method for the following events: 

EVENT_FORMATTED_SMS_PP_ENV 

EVENT_UNFORMATTED_SMS_PP_ENV 

EVENT_FORMATTED_SMS_CB 

EVENT_UNFORMATTED_SMS_CB 

EVENT_MENU_SELECTION 

EVENT_MENU_SELECT10N_HELP_REQUEST 

EVENT_T1MER_EXP1RAT10N 

EVENT_EVENT_DOWNLOAD_MT_CALL 

EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED 

EVENT_EVENT_DOWNLOAD_LOCATION_STATUS 

EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_A VAIL ABLE 

EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 

EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION 

EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION 

EVENT_UNRECOGNIZED_ENVELOPE 

EVENT_STATUS_COMMAND 

EVENT_CALL_CONTROL 

EVENT_SMS_MO_CONTROL 

EVENT_PROFlLE_DOWNLOAD 

6.3.1 .1 .1 .2 Parameters error 

No requirements. 
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6.3.1.1.1.3 

No requirements. 

6.3.1.1.2 

Test Script: 
Test Applet: 

Load Script: 
Cleanup Script: 
Parameter File: 



Context errors 

Test Suite Files 

FWK_MHA_PAHD_1 .scr 
FWK_MHA_PAHD_1 .java 
FWK_MHA_PAHD_2.java 
FWK_MHA_PAHD_1 .Idr 
FWK_MHA_PAHD_1 .clr 
FWK_MHA_PAHD_1 .par 



6.3.1.1.3 



Test Procedure 



Id 



Description 



API /Framework Expectation 



APDU Expectation 



Applets registration to all events and Proactive 
Handler availability with 
EVENT_PROFILE_DOWNLOAD 

Appletl is registered to all events 
defined in [7] . 

Using the methods initMenuEntry () for 
EVENT_MENU_SELECTION, requestPollInterval 
for EVENT_STATUS_COMMAND, allocateTimer 
for EVENT_TIMER_EXPIRATION and 
setEventList () for the rest of the 
events . 

Applet2 is registered to all events 
defined in [7], except 
EVENT_CALL_CONTROL_BY_SIM and 
EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM. 
Using the methods initMenuEntry () for 
EVENT_MENU_SELECTION, requestPollInterval 
for EVENT_STATUS_COMMAND, allocateTimer 
for EVENT_TIMER_EXPIRATION and 
setEventList () for the rest of the 
events . 

The priority of appletl is higher than 
priority of applet2 

1- Terminal Profile command is sent to SIM 
without the facility of SET_EVENT_LIST, 
POLL_INTERVAL, SET UP IDLE MODE TEXT and 
SET UP MENU. 

2- Appletl gets the Proactive Handler 
Appletl is deregistered to 
EVENT_PROFILE_DOWNLOAD 



3-Applet2 gets the Proactive Handler 
Applet2 is deregistered to 
EVENT PROFILE DOWNLOAD 



1 - Appletl is triggered 



2- No exception is thrown. 



3- Applet2 is triggered 

4- No exception is thrown 



Appletl finalizes 
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Id 


Description 


API /Framework Expectation 


APDU Expectation 


2 


Proactive Handler availability with 
EVENT_MENU_SELECTION_HELP_REQUEST 

Perform SIM initialization with all the 
facilities supported 

1- Envelope menu selection with help 
request is sent to the SIM 

2- Appletl gets the Proactive Handler 

3- Envelope menu selection with help 
request is sent to the SIM 

4- Applet2 gets the Proactive Handler 


1 - Appletl is triggered 

2- No exception is thrown 

Appletl finalizes 

3- Applet2 Is triggered 

4- No exception Is thrown 




3 


Proactive Handler availability with 
EVENT_MENU_SELECTION 

1- Envelope menu selection is sent to the 
SIM 

2- Appletl gets the Proactive Handler 

3- Envelope menu selection is sent to the 
SIM 

4- Applet2 gets the Proactive Handler 


1 - Appletl Is triggered 

2- No exception Is thrown. 
Appletl finalizes 

3- Applet2 Is triggered 

4- No exception Is thrown. 




4 


Proactive Handler availability with 
EVENT_FORMATTED_SMS_PP_ENV 

1- Envelope dataDownLoad formatted is sent 
to the SIM 

2- Appletl gets the Proactive Handler 

3- Envelope dataDownLoad formatted is sent 
to the SIM 

4- Applet2 gets the Proactive Handler 


1 - Appletl Is triggered 

2- No exception Is thrown. 

Appletl finalizes 

3- Applet2 Is triggered 

4- No exception Is thrown. 




5 


Proactive Handler availability with 
EVENT_UNFORMATTED_SMS_PP_ENV 

1- Envelope dataDownLoad unformatted is 
sent to the SIM 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1 - Appletl Is triggered 

2- No exception Is thrown. 
Appletl finalizes 

3- Applet2 is triggered 

4- No exception Is thrown. 
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Id 


Description 


API /Framework Expectation 


APDU Expectation 


6 


Proactive Handler availability with 
EVENT_FORMATTED_CELL BROADCAST 

1- Envelope cell broadcast formatted is 

sent to the SIM 

2- Appletl gets the Proactive Handler 

3- Envelope cell broadcast formatted is 
sent to the SIM 

4- Applet2 gets the Proactive Handler 


1 - Appletl is triggered 

2- No exception is thrown 

Appletl finalizes 

3- Applet2 is triggered 

4- No exception is thrown 




7 


Proactive Handler availability with 
EVENT_UNFORMATTED_CELL BROADCAST 

1- Envelope cell broadcast unformatted is 
sent to the SIM 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1- Appletl is triggered 

2- No exception is thrown 
Appletl finalizes 

3- Applet2 is triggered 

4- No exception is thrown 




8 


Proactive Handler availability with 
EVENT_TIIUIER_EXPIRATION 








l-Timer Id =1 

Envelope Timer Expiration is sent to the 
SIM 


1 - Appletl is triggered 
2- No exception is thrown. 






2- Appletl gets the Proactive Handler 

3- Timer id=2 

Envelope Timer Expiration is sent to the 
SIM 


Appletl finalizes 

3- Applet2 is triggered 






4- Applet! gets the Proactive Handler 


4- No exception is thrown 




q 


Prnflptivp Hflnrilpr flvailflhilitv with 

I^IWCIvllVC llClllVlId CI Vul IBUI II &y Willi 

EVENT_CALL_CONTROL_BY_SIM 

1- Envelope call control by SIM is sent to 
the SIM 

2- Appletl gets the Proactive Handler 


1 - Appletl is triggered 
2- No exception is thrown. 




10 


Proactive Handler availability with 
EVENT_MO_SHORT_IUIESSAGE_CONTROL 

1- Envelope mo short message control by SIM 
is sent to the SIM 

2- Appletl gets the Proactive Handler 


1 - Appletl is triggered 
2- No exception is thrown 
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Id 


Description 


API /Framework Expectation 


APDU Expectation 


11 


Proactive Handler availability with 
EVENT_EVENT_DOWNLOAD_MT_CALL 

1- Envelope event download mt call is sent 
to the SIM 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1 - Appletl is triggered 

2- No exception is thrown. 

Appletl finalizes 

3- Applet2 is triggered 

4- No exception is thrown 




12 


Proactive Handler availability with 
EVENT EVENT DOWNLOAD CALL CONNECT 
ED 

1- Envelope event download call connected 
is sent to the SIM 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1 - Appletl is triggered 

2- No exception is thrown. 
Appletl finalizes 

3- Applet2 is triggered 

4- No exception is thrown 




13 


Proactive Handler availability with 
EVENT EVENT DOWNLOAD CALL DISCONN 
ECTED 

1- Envelope event download call 
disconnected is sent to the SIM 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1 - Appletl is triggered 

2- No exception is thrown. 

Appletl finalizes 

3- Applet2 is triggered 

4- No exception is thrown. 




14 


Applets triggering with 
EVENT_EVENT_LOCATION_STATUS 

1- Envelope event download location status 
is sent to the SIM 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1 - Appletl is triggered 

2- No exception is thrown. 
Appletl finalizes 

3- Applet2 is triggered 

4- No exception is thrown 
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Id 


Description 


API /Framework Expectation 


APDU Expectation 


15 


Proactive Handler availability with 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

1- Envelope event download user activity is 
sent to SIM 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1 - Appletl is triggered 

2- No exception is thrown 
Appletl finalizes 

3- Applet2 Is triggered 

4- No exception Is thrown 




16 


Proactive Handler availability with 
EVENT EVENT DOWNLOAD IDLE SCREEN 
AVAILABLE 

1- Envelope event download idle screen 
available is sent to the SIM 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1 - Appletl Is triggered 

2- No exception Is thrown. 
Appletl finalizes 

3- Applet2 is triggered 

4- No exception Is thrown 




17 


Proactive Handler availability with 
EVENT EVENT DOWNLOAD CARD READER 
_STATUS 

1- Envelope event download card reader 
status is sent to the SIM 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1 - Appletl Is triggered 

2- No exception Is thrown. 

Appletl finalizes 

3- Applet2 is triggered 

4- No exception Is thrown 




18 


Proactive Handler availability with 
EVENT EVENT DOWNLOAD LANGUAGE SE 
LECTION 

1- Envelope event download language 
selection is sent to the SIM 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1 - Appletl Is triggered 

2- No exception is thrown. 

Appletl finalizes 
Applet2 is triggered 

3- No exception Is thrown 
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Id 


Description 


API /Framework Expectation 


APDU Expectation 


19 


Proactive Handler availability with 
EVENT EVENT DOWNLOAD BROWSER TER 
MINATION 

1- Envelope event download browser 
termination is sent to the SIM 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1 - Appletl is triggered 

2- No exception is thrown. 
Appletl finalizes 
Applet2 is triggered 

3- No exception is thrown 




20 


Proactive Handler availability with 
EVENT_STATUS_COMMAND 

1- Status command is sent to the SIM 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1 - Appletl is triggered 

2- No exception is thrown. 

Appletl finalizes 

3- Applet2 is triggered 

4- No exception is thrown. 




21 


Proactive Handler availability with 
UNRECOGNIZED_ENVELOPE 

1- An unrecognized Envelope (BER TLV Tag 
unrecognized) is sent to the SIM 

2- Appletl gets the Proactive Handler 

3- Applet2 gets the Proactive Handler 


1 - Appletl is triggered 

2- No exception is thrown. 

Appletl finalizes 

3- Applet2 is triggered 

4- No exception is thrown 





6.3.1.1.4 Test Coverage 



GRR Number 


Test Case Number 


CRRN1 


1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15 16, 17, 18, 19, 20, 21 



6.3.1.2 ProactiveResponseHandler 

Test Area Reference: FWK_MHA_PRHD. 

6.3.1.2.1 Conformance Requirement 

6.3.1.2.1.1 Normal Execution 

• CRRNl : The ProactiveResponseHandler is available after the first call to the ProactiveHandler.send method to 
the termination of the processToolldt method for the following events: 

EVENT_FORMATTED_SMS_PP_ENV 

EVENT_UNFORMATTED_SMS_PP_ENV 

EVENT_FORMATTED_SMS_CB 
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EVENT_UNFORMATTED_SMS_CB 

EVENT_MENU_SELECTION 

EVENT_MENU_SELECTION_HELP_REQUEST 

EVENT_TIMER_EXPIRATION 

EVENT_EVENT_DOWNLOAD_MT_CALL 

EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED 

EVENT_EVENT_DOWNLOAD_LOCATION_STATUS 

EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 

EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 

EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION 

EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION 

EVENT_UNRECOGNIZED_ENVELOPE 

EVENT_STATUS_COMMAND 

EVENT_CALL_CONTROL 

EVENT_SMS_MO_CONTROL 

EVENT_PROFILE_DOWNLOAD 

6.3.1 .2.1 .2 Parameters error 
No requirements. 

6.3.1 .2.1 .3 Context errors 

No requirements. 

6.3.1.2.2 Test Suite Files 

Test Script: FWK_MHA_PRHD_l.scr 
Test Applet: FWK_MHA_PRHD_1 .Java 



FWK_MHA_PRHD_2.java 



Load Script: 



FWK_MHA_PRHD_1 .Idr 



Cleanup Script: 



FWK_MHA_PRHD_1 .clr 



Parameter File: 



FWK_MHA_PRHD_1 .par 
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6.3.1 .2.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applets registration to all events and Proactive 
Response Handler availability with 
EVENT_PROFILE_DOWNLOAD 

1- Appletl is registered to all events 
defined in [7], applet2 is registered to 
all events defined in [7] except 
EVENT_CALL_CONTROL_BY_SIM and 
EVENT_MO_SMS_CONTROL_B Y_S IM . 
Using the methods initMenuEntry ( ) for 

EVENT_MENU SELECTION, 

requestPollInterval ( ) for 

EVENT_STATUS_COMMAND, allocateTimer ( ) for 
EVENT_TIMER_EXPIRATION and setEventList ( ) 
for the rest of the events. 

1-Terminal Profile command is sent to the 
SIM without the facility of SET_EVENT_LIST 
and POLL_INTERVAL, , SET UP IDLE MODE TEXT 
and SET UP MENU. 


1 -Appletl is triggered 
No exception is thrown 






Appletl builds a proactive command DISPLAY 
TEXT . 

2- ProactiveHandler . send ( ) method is 
called 


3- No exception is tlirown 


2- The proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 




3- 

ProactiveResponseHandler . getTheHandler ( ) 
method is called 








Appletl is deregistered to 
EVENT_PROF I LE_DOWNLOAD 


Appletl finalizes 






Applet2 builds a proactive command DISPLAY 
TEXT . 

4- ProactiveHandler . send ( ) method is 
called 


4- Applet2 is triggered 


5- The proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 




5- 

Proact IveResponseHandler . getTheHandler ( ) 

method is called 

Appletl is deregistered to 
EVENT_PROFILE_DOWNLOAD 


6- No exception is thrown 
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Id 



Description 



API/Framework Expectation 



APDU Expectation 



Proactive Response Handler availability with 
EVENT_MENU_SELECTION_HELP_REQUEST 

Perform SIM initialization with all the 

facilities supported 

1-Envelope menu selection with help 
request is sent to the SIM 



Appletl builds a proactive command DISPLAY 

TEXT 

2- ProactiveHandler . send ( ) method is 
called 



ProactiveResponseHandler . getTheHandler { ) 

method is called 

Appletl execution is finished 

Envelope menu selection with help request 

is sent to the SIM 



Applet2 builds a proactive command DISPLAY 
TEXT 

4- ProactiveHandler . send ( ) method is 
called 



5-ProactiveResponseHandler . getTheHandler ( ) 
method is called 



1 - Appletl is triggered 



3- No exception is tlirown 
Appletl finalizes 

4- Applet2 is triggered 



6- No exception is thrown 



2- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 



5- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 



Proactive Response Handier availability witli 
EVENT_iU!ENU_SELECTiON 

1- Envelope menu selection is sent to the 
SIM 

Appletl builds a proactive command DISPLAY 

TEXT 

2- ProactiveHandler . send ( ) method is 
called 



3-ProactiveResponseHandler . getTheHandler ( ) 
method is called 



4-Envelope menu selection is sent to the 
SIM 



Applet2 builds a proactive command DISPLAY 

TEXT 

5- ProactiveHandler . send ( ) method is 
called 



6 -ProactiveResponseHandler . getTheHandler ( ) 
method is called 



1 - Appletl is triggered 



3- No exception is thrown 
Appletl finalizes 

4- Applet2 is triggered 



6- No exception is thrown 



2- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 



5- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


4 


Proactive Response Handler availability with 
EVENT_FORMATTED_SMS_PP_ENV 

1- Envelope dataDownLoad formatted is sent 
to the SIM 

Applet builds a proactive command DISPLAY 

TEXT 

2- ProactiveHandler . send ( ) method is called 


1 - Appletl is triggered 


2- A proactive command 
DISPLAY TEXT is fetched 




3- ProactiveResponseHandler . getXheHandler ( ) 
method is called 

4- Envelope dataDownLoad formatted is sent 
to the SIM 


3- No exception is tlirown 
Appletl finalizes 

4- Applet2 is triggered 


TERMINAL RESPONSE 




Applet2 builds a proactive command DISPLAY 
TEXT 

5-ProactiveHandler . send ( ) method is called 




5- A proactive command 
DISPLAY TEXT is fetched 




6-ProactiveResponseHandler . getTheHandler ( ) 

method is called 


6- No exception is thrown 


TERMINAL RESPONSE 


5 


Proactive Response Handler availability with 
EVENT_UNFORMATTED_SMS_PP_ENV 

1- Envelope dataDownLoad unformatted is 
sent to the SIM 

Appletl builds a proactive command DISPLAY 
TEXT 

2- ProactiveHandler . send ( ) method is 
called 

3- 

ProactiveResponseHandler . getTheHandler ( ) 
method is called 


1 - Appletl is triggered 

3- No exception is thrown 
Appletl finalizes 


2- A proactive command 
DISPLAY TEXT is fetched 

1 triMINML ritorUNot 




Applet2 builds a proactive command DISPLAY 
TEXT 

4- ProactiveHandler . send ( ) method is 
called 


4- Applet2 is triggered 


5- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 




5- 

ProactiveResponseHandler . getTheHandler ( ) 
method is called 


6- No exception is thrown 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


6 


Proactive Response Handler availability with 
EVENT_UNFORMATTED_SMS _CB 

1- Envelope call broadcast unformatted is 
sent to the SIM 

Appletl builds a proactive command DISPLAY 

TEXT 

2- ProactiveHandler . send ( ) method is called 


1 - Appletl is triggered 


2- A proactive command 
DISPLAY TEXT is fetched 




3-ProactiveResponseHandler . getXheHandler ( ) 
method is called. 


3- No exception is tlirown 


TERMINAL RESPONSE 




Applet2 builds a proactive command DISPLAY 

TEXT 


Appletl finalizes 






4- ProactiveHandler . send ( ) method is 
called 


4- Applet2 is triggered 








5- A proactive command 
DISPLAY TEXT is fetched 




5- 




TERMINAL RESPONSE 




ProactiveResponseHandler . getXheHandler { ) 
method is called 


6- No exception is thrown 




7 


Proactive Response Handler availability with 
EVENT_UNFORMATTED_SMS _CB 

1- Envelope call broadcast unformatted is 
sent to the SIM 

Appletl builds a proactive command DISPLAY 
TEXT 

2- ProactiveHandler . send ( ) method is called 


1 - Appletl is triggered 


2- A proactive command 
DISPLAY TEXT is fetched 




3-ProactiveResponseHandler . getTheHandler ( ) 
method is called. 


3- No exception is thrown 

Appletl finalizes 

4- Applet2 is triggered 


TERMINAL RESPONSE 




Applet2 builds a proactive command DISPLAY 
TEXT 








4- ProactiveHandler . send ( ) method is 
called 




5- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 




5- 

ProactiveResponseHandler . getTheHandler ( ) 
method is called 


6- No exception is thrown 
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Irl 
lu 


uescnpiion 


Mri/rraineworK cxpeciaiion 


Aruu txpeciaiion 


8 


Proactive Response Handler availability with 
EVENT_TIMER_EXPIRATION 








Timer id=l 

1-Envelope Timer Expiration is sent to the 
SIM 


1- Appletl is triggered 






Applst builds 3 piro3.ctivs corrirri3.rici DISPLAY 
TEXT 








2-ProactiveHandler . send ( ) method is called 




2- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 




3-ProactiveResponseHandler . getTheHandler ( ) 
method is called 


3- No exception is thrown 






Timer id=2 

Envelope Timer Expiration is sent to the 
SIM 


Annlpti finaliypQ 

AA|J|Jld 1 III ICLIIACo 






Applet builds a proactive command DISPLAY 
TEXT 


4- Applet2 is triggered 






4-ProactiveHandler . send ( ) method is called 


5- No exception is thrown 






5-ProactiveResponseHandler . getTheHandler ( ) 
method is called 




6- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 


9 


Proactive Response Handler availability with 
EVENT_CALL_CONTROL_BY_SIM 

1- Envelope call control by sim is sent to 
the SIM 

Applet builds a proactive command DISPLAY 
TEXT 

2- ProactiveHandler . send ( ) method is called 


1 - Appletl is triggered 


2- A proactive command 
DISPLAY TEXT is fetched 




3-ProactiveResponseHandler . getTheHandler ( ) 
method is called 


3- No exception is thrown 


TERMINAL RESPONSE 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


10 


Proactive Response Handler availability witli 
MO_SHORT_MESSAGE_CONTROL_BY_SIM 

l-Envelope mo short message control by sim 
is sent to the SIM 

Applet builds a proactive command DISPLAY 
TEXT 


1 - Appletl is triggered 






2- ProactiveHandler . send ( ) method is called 

3- ProactiveResponseHandler.getTheHandler() method is 
called 


3- No exception is thrown 


2- A proactive command 
DISPLAY TEXT is fetched 
TERMINAL RESPONSE 


11 


Proactive Response Handler availability with 
EVENT_EVENT_DOWNLOAD_MT_CALL 

l-Envelope event download mt call is sent 
to the SIM 

Appletl builds a proactive command DISPLAY 
TEXT 


1 - Appletl is triggered 






2- ProactiveHandler . send ( ) method is called 

3- ProactiveResponseHandler . getTheHandler ( ) 
method is called. 


3- No exception is thrown 
Appletl finalizes 


2- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 




Applet2 builds a proactive command DISPLAY 

TEXT 


4- Applet2 is triggered 






4- ProactiveHandler . send ( ) method is 
called 




5- A proactive command 
DISPLAY TEXT is fetched 




5- 

ProactiveResponseHandler . getTheHandler ( ) 
method is called 


6- No exception is thrown 


TERMINAL RESPONSE 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


12 


Proactive Response Handler availability with 
EVENT EVENT DOWNLOAD CALL CONNECT 

ED 

1- Envelope event download call connected 
is sent to the SIM 

Appletl builds a proactive command DISPLAY 
TEXT 

2- ProactiveHandler . send ( ) method is called 


1 - Appletl is triggered 


2- A proactive command 
DISPLAY TEXT is fetched 




3~P roact iveResponseHandler . getTheHandler ( ) 
method is called 


3- No exception is thrown 
Appletl finalizes 


TERMINAL RESPONSE 




Applet builds a proactive command DISPLAY 
TEXT 


4- Applet2 is triggered 






4- ProactiveHandler . send ( ) method is 
called 




5- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 




5- 

ProactiveResponseHandler . getTheHandler ( ) 
method is called 


6- No exception is thrown 




13 


Proactive Response Handler availability with 
EVENT EVENT DOWNLOAD CALL DISCONN 
ECTED 

1- Envelope event download call 
disconnected is sent to the SIM 

Appletl builds a proactive command DISPLAY 
TEXT 

2- ProactiveHandler . send ( ) method is called 

3- ProactiveResponseHandler . getTheHandler ( ) 
method is called 

Applet2 builds a proactive command DISPLAY 

TEXT 

4- ProactiveHandler . send ( ) method is 
called 


1 - Appletl is triggered 

3- No exception is thrown 
Appletl finalizes 

4- Applet2 is triggered 


2- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 




5- 

ProactiveResponseHandler . getTheHandler ( ) 
method is called 


6- No exception is thrown 


5- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


14 


Proactive Response Handler availability with 
EVENT EVENT DOWNLOAD LOCATION STA 
TUS 

1- Envelope event download location status 
is sent to the SIM 

Appletl builds a proactive command DISPLAY 
TEXT 

2- ProactiveHandler . send ( ) method is called 

3- ProactiveResponseHandler . getTheHandler ( ) 
method is called 

Applet2 builds a proactive command DISPLAY 
TEXT 

4- ProactiveHandler . send ( ) method is 
called 


1 - Appletl is triggered 

3- No exception is tlirown 

Appletl finalizes 

4- Applet2 is triggered 


2-A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 

5- A proactive command 
DISPLAY TEXT is fetched 




5- 

ProactiveResponseHandler . getTheHandler ( ) 
method is called 


6- No exception is thrown 


TERMINAL RESPONSE 


15 


Proactive Response Handler availability with 
EVENT_EVENT_DOWNLOAD_USER_ACTiVITY 

1- Envelope event download user activity is 
sent to the SIM 

Appletl builds a proactive command DISPLAY 

TEXT 

2- ProactiveHandler . send ( ) method is called 


1 - Appletl is triggered 


2-A proactive command 
DISPLAY TEXT is fetched 




3-Proact IveResponseHandler . getTheHandler ( ) 


3- No exception is thrown 
Appletl finalizes 


TERMINAL RESPONSE 




Applet2 builds a proactive command DISPLAY 
TEXT 


4- Applet2 is triggered 






4- ProactiveHandler . send ( ) method is 
called 




5- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 




5- 

P react IveResponseHandler . getTheHandler ( ) 
method is called 


6- No exception is thrown 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


16 


Proactive Response Handler availability with 








EVENT_EVENT_DOWNLOADJDLE_SCREEN_ 








AVAII ARI F 








1-Envelope event download idle screen 


1 - Appletl is triggered 






available is sent to the SIM 






Appletl builds a proactive command DISPLAY 








TEXT 








2-ProactiveHandler . send ( ) method is called 




2- A proactive command 








DISPLAY TEXT is fetched 








TERMINAL RESPONSE 




3-ProactiveResponseHandler . getTheHandler ( ) 


3- No exception is thrown 






method is called 










Appletl finalizes 








4- Applet2 is triggered 






Applet2 builds a proactive command DISPLAY 








TEXT 












5- A proactive command 




4— ProactiveHandler . send ( ) method is 




DISPLAY TEXT is fetched 




called 












TERMINAL RESPONSE 




5- 

ProactiveResponseHandler . getTheHandler ( ) 








method is called 


6- No exception is thrown 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


17 


Proactive Response Handler availability with 








FVFNT FVFNT DDWNI nAD 1 ANf^llAnF 








SELECTION 








l-Envelope event download language 


1 - Appletl is triggered 






selection is sent to the SIM 






Appletl builds a proactive command DISPLAY 








'FIT 

itjA i 








2-ProactiveHandler . send ( ) method is called 












2-A oroactive command 








DISPLAY TEXT is fetched 








TERMINAL RESPONSE 




3-ProactiveResponseHandler . getXheHandler ( ) 








method is called 










3-No exception is thrown 








Appletl finalizes 






Applet2 builds a proactive command DISPLAY 


Applet2 is triggered 






TEXT 








4- ProactiveHandler . send ( ) method is 








called 








5- 

ProactiveResponseHandler . getTheHandler ( ) 




4-A proactive command 




method is called 




DISPLAY TEXT is fetched 








TERMINAL RESPONSE 






5-No exception is thrown 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


18 


Proactive Response Handler availability with 








FVFNT FVFNT HOWNI OAD RROW^FR 








TERMINATION 








1-Envelope event download Browser 


1 - Appletl is triggered 






termination is sent to the SIM 








Appletl builds a proactive command DISPLAY 








'FIT 

itjA i 








2-ProactiveHandler . send ( ) method is called 












2-A oroactive command 








DISPLAY TEXT is fetched 








TERMINAL RESPONSE 




3-ProactiveResponseHandler . getXheHandler ( ) 








method is called 










3-No exception is thrown 








Appletl finalizes 






Applet2 builds a proactive command DISPLAY 


Applet2 is triggered 






TEXT 








4- ProactiveHandler . send ( ) method is 








called 








5- 

ProactiveResponseHandler . getTheHandler ( ) 




4-A proactive command 




method is called 




DISPLAY TEXT is fetched 








TERMINAL RESPONSE 






5-No exception is thrown 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


19 


Proactive Response Handler availability with 
EVENT_STATUS_COMMAND 

1- Status command is sent to the SIM 

Appletl builds a proactive command DISPLAY 
TEXT 

2- ProactiveHandler . send ( ) method is called 

3- ProactiveResponseHandler . getTheHandler ( ) 
method is called 


1 - Appletl is triggered 

3- No exception is thrown 
Appletl finalizes 


2- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 




Applet2 builds a proactive command DISPLAY 
TEXT 

4- ProactiveHandler . send ( ) method is 
called 


4- Applet2 is triggered 


5- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 




5- 

ProactiveResponseHandler . getTheHandler ( ) 

method is called 


6- No exception is thrown 




20 


Proactive Response Handler availability with 
UNRECOGNIZED_ENVELOPE 

1- An unrecognized Envelope is sent to the 
SIM 

Appletl builds a proactive command DISPLAY 
TEXT 

2- ProactiveHandler . send ( ) method is called 

3- ProactiveResponseHandler . getTheHandler ( ) 
method is called 


1 - Appletl is triggered 

3- No exception is thrown 
Appletl finalizes 


2- A proactive command 
DISPLAY TEXT is fetched 

TERMINAL RESPONSE 




Applet2 builds a proactive command DISPLAY 
TEXT 


4- Applet2 is triggered 


5- A proactive command 
DISPLAY TEXT is fetched 




4- ProactiveHandler . send ( ) method is 
called 




TERMINAL RESPONSE 




5- 

ProactiveResponseHandler . getTheHandler ( ) 
method is called 


6- No exception is thrown 
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6.3.1 .2.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19, 20 



6.3.1.3 EnvelopeHandler 

Test Area Reference: FWK_MHA_ENHD. 
6.3.1.3.1 Conformance Requirement 

6.3.1.3.1.1 Normal Execution 

• CRRNl: The EnvelopeHandler and its content are available for all toolkit applets triggered from the invocation 
to the termination of their processToolldt method for the following events: 

EVENT_FORMATTED_SMS_PP_ENV 

EVENT_UNFORMATTED_SMS_PP_ENV 

EVENT_FORMATTED_SMS_CB 

EVENT_UNFORMATTED_SMS_CB 

EVENT_MENU_SELECT10N 

EVENT_MENU_SELECT10N_HELP_REQUEST 

EVENT_TIMER_EXPIRATION 

EVENT_EVENT_DOWNLOAD_MT_CALL 

EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED 

EVENT_EVENT_DOWNLOAD_LOCATION_STATUS 

EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

EVENT_EVENT_DOWNLOAD_lDLE_SCREEN_AVAlLABLE 

EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 

EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION 

EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION 

EVENT_UNRECOGNIZED_ENVELOPE 

EVENT_CALL_CONTROL 

EVENT_SMS_MO_CONTROL 

6.3.1 .3.1 .2 Parameters error 

No requirements. 

6.3.1.3.1.3 Context Errors 

• CRRCl: The EnvelopeHandler and its content are not available for any toolkit applet triggered from the 
invocation to the termination of their processToolkit method for the following events: 

EVENT_STATUS_COMMAND 
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EVENT PROFILE DOWNLOAD 



6.3.1.3.2 

Test Script: 
Test Applet: 

Load Script: 
Cleanup Script: 
Parameter File: 

6.3.1.3.3 



Test Suite Files 

FWK_MHA_ENHD_1 .scr 
FWK_MHA_ENHD_1 .Java 
FWK_MHA_ENHD_2.java 
FWK_MHA_ENHD_1 .Idr 
FWK_MHA_ENHD_1 .clr 
FWK_MHA_ENHD_1 .par 

Test Procedure 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



Appletl and Applet2 registration and Envelope 
Handler availability with 
EVENT PROFILE DOWNLOAD 



1- Appletl is registered to all events 
defined [7] . 

Using the methods initMenuEntry ( ) for 
EVENT_MENU_SELECTION, 
requestPollInterval ( ) for 

EVENT_STATUS_COMMAND, allocateTimer ( ) for 
EVENT_TIMER_EXPIRATION and setEventList ( ) 
for the rest of the events. 



Applet2 is registered to all events 
defined [7] except 
EVENT_CALL_CONTROL_BY_SIM and 
EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM. 
Using the methods initMenuEntry ( ) for 
EVENT_MENU_SELECTION, 
requestPollInterval ( ) for 
EVENT_STATUS_COMMAND, allocateTimer for 
EVENT_TIMER_EXPIRATION and setEventList 
for the rest of the events. 

2-Terminal Profile command is sent to SIM 
without the facility of SET_EVENT_LIST 
, SETUP_IDLE_MODE_TEXT , POLL_INTERVAL and 
SETUP MENU 



3-EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 
Appletl is deregistered to 
EVENT PROFILE DOWNLOAD 



4-EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 
Applet2 is deregistered to 
EVENT_PROFILE_DOWNLOAD 



1 - No exception is tiirown 



2- Appletl is triggered 



3- A Tooll<it exception 
HANDLER_NOT_AVAILABLE is 
tiirown 

4- Applet2 is triggered 



5- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


2 


Envelope Handler availability with 
EVENT_MENU_SELECTION_HELP_REQUEST 

Perform SIM initialization with all the 
facilities supported 

Envelope menu selection with help request 
is sent to the SIM 

1- EnvelopeHandler . getXheHandler ( ) method 
is called by Appletl 

2- Envelope menu selection with help 
request is sent to the SIM 

3- EnvelopeHandler . getlheHandler ( ) method 
is called by Applet2 


1 - Appletl is triggered 

2- No exception is tlirown. 

Appletl finalizes 

3- Applet2 is triggered 

4- No exception is thrown. 




3 


Envelope Handler availability with 
EVENT_MENU_SELECTION 

1- Envelope menu selection is sent to the 
SIM 

2- EnvelopeHandler . getXheHandler ( ) method 
is called by Appletl 

3- Envelope menu selection is sent to the 
SIM 

4- EnvelopeHandler . getXheHandler ( ) method 
is called by Applet2 


1 - Appletl is triggered 

2- No exception is thrown. 
Appletl finalizes 

3- Applet2 is triggered 

4- No exception is thrown. 




4 


Envelope Handler availability with 
EVENT_FORMATTED_SMS_PP_ENV 

1- A EVENT_FORMATXED_SMS_PP_ENV envelope is 
sent to the SIM 

2- EnvelopeHandler . getXheHandler ( ) method 
is called by Appletl 

3- A EVENX_FORMAXXED_SMS_PP_ENV envelope is 
sent to the SIM 

4- EnvelopeHandler . getXheHandler ( ) method 
is called by Applet2 


1 - Appletl is triggered 

2- No exception is thrown. 
Appletl finalizes 

3- Applet2 is triggered 

4- No exception is thrown. 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


5 


Envelope Handler availability with 
EVENT_UNF0RIU1ATTED_SMS_PP_ENV 

1- An unformatted sms pp envelope is sent 
to the SIM 

2- EnvelopeHandler . getXheHandler ( ) method 
is called by Appletl 

3- EnvelopeHandler . getXheHandler ( ) method 
is called by Applet2 


1 - Appletl is triggered 

2- No exception is thrown. 
Appletl finalizes 

3- Applet2 is triggered 

4- No exception is thrown. 




6 


Envelope Handler availability with 
EVENT_FORMATTED_CB 

1- Envelope cell broadcast formatted is 
sent to the SIM 

2- EnvelopeHandler . getXheHandler ( ) method 
is called by Appletl 

3- Envelope cell broadcast formatted is 
sent to the SIM 

4- EnvelopeHandler . getXheHandler ( ) method 
is called by Applet2 


1 - Appletl is triggered 

2- No exception is thrown 
Appletl finalizes 

3- Applet2 is triggered 

4- No exception is thrown 




7 


Envelope Handler availability with 
EVENT_UNFORMATTED_CB 

1- Envelope cell broadcast unformatted is 
sent to the SIM 

2- EnvelopeHandler . getXheHandler ( ) method 
is called by Appletl 

3- EnvelopeHandler . getXheHandler ( ) method 
is called by Applet2 


1 - Appletl is triggered 

2- No exception is thrown 
Appletl finalizes 

3- Applet2 is triggered 

4- No exception is thrown 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


8 


Envelope Handler availability with 
EVENT_TIMER_EXPIRATION 

Timer id=l 

1- Envelope Timer Expiration is sent to the 
SIM 

2- EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 

Timer id=2 

3~Envelope Timer Expiration is sent to the 
SIM 

4-EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 


1 - Appletl is triggered 

2- No exception is thrown. 
Appletl finalizes 

3- Applet2 is triggered 

4- No exception is thrown. 




9 


Envelope Handler availability with 
EVENT_CALL_CONTROL_BY_SIM 

1- Envelope call control by sim is sent to 
the SIM 

2- EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 


1 - Appletl is triggered 
2- No exception is thrown. 




10 


Envelope Handler availability with 
EVENT MO SHORT lUIESSAGE CONTROL B 
Y_SIM 

1- Envelope mo short message control by sim 
is sent to the SIM 

2- EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl. 


1 - Appletl is triggered 

2- No exception is throw 




11 


Envelope Handler availability with 
EVENT_EVENT_DOWNLOAD_MT_CALL 

1- Envelope event download mt call is sent 
to the SIM 

2- EnvelopeHandler . getTheHandler ( ) method 
is called by Appletl 

3- EnvelopeHandler . getTheHandler ( ) method 
is called by Applet2 


1- Appletl is triggered 

2- No exception is thrown. 

Appletl finalizes 

3- Applet2 is triggered 

4- No exception is thrown. 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


12 


Envelope Handler availability with 
EVENT EVENT DOWNLOAD CALL CONNECT 
ED 

1- Envelope event download call connected 
is sent to the SIM 

2- EnvelopeHandler . getXheHandler ( ) method 
is called by Appletl 

3- EnvelopeHandler . getXheHandler ( ) method 
is called by Applet2 


1 - Appletl is triggered 

2- No exception Is thrown. 
Appletl finalizes 

3- Applet2 is triggered 

4- No exception Is thrown. 




13 


Envelope Handler availability with 
EVENT EVENT DOWNLOAD CALL DISCONE 
CTTED 

1- Envelope event download call 
disconnected is sent to the SIM 

2- EnvelopeHandler . getXheHandler ( ) method 
is called by Appletl 

3- EnvelopeHandler . getXheHandler ( ) method 
is called by Applet2 


1- Appletl is triggered. 

2- No exception Is thrown. 
Appletl finalizes 

3- Applet2 Is triggered 

4- No exception Is thrown. 




14 


Envelope Handler availability with 
EVENT EVENT DOWNLOAD LOCATION STA 
TUS 

1- Envelope event download location status 
is sent to the SIM 

2- EnvelopeHandler . getXheHandler ( ) method 
is called by Appletl 

3- EnvelopeHandler . getXheHandler ( ) method 
is called by Applet2 


1 - Appletl is triggered 

2- No exception Is thrown. 
Appletl finalizes 

3- Applet2 is triggered 

4- No exception Is thrown. 




15 


Envelope Handler availability with 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

1- Envelope event download user activity is 
sent to the SIM 

2- EnvelopeHandler . getXheHandler ( ) method 
is called by Appletl 

3- EnvelopeHandler . getXheHandler ( ) method 
is called by Applet2 


1 - Appletl Is triggered 

2- No exception Is thrown 
Appletl finalizes 

3- Applet2 Is triggered 

4- No exception Is thrown 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


16 


Envelope Handler availability with 
EVENT EVENT DOWNLOAD IDLE SCREEN 
AVAILABLE 

1- Envelope event download idle screen 
available is sent to the SIM 

2- EnvelopeHandler . getXheHandler ( ) method 
is called by Appletl 

3- EnvelopeHandler . getXheHandler ( ) method 
is called by Applet2 


1 - Appletl is triggered 

2- No exception is tlirown. 
Appletl finalizes 

3- Applet2 is triggered 

4- No exception is thrown. 




17 


Envelope Handler availability with 
EVENT EVENT DOWNLOAD CARD READER 
_STATUS 

1- Envelope event download card reader 
status is sent to the SIM 

2- EnvelopeHandler . getXheHandler ( ) method 
is called by Appletl 

3- EnvelopeHandler . getXheHandler ( ) method 
is called by Applet2 


1 - Appletl is triggered 

2- No exception is thrown. 
Appletl finalizes 

3- Applet2 is triggered 

4- No exception is thrown. 




18 


Envelope Handler availability with 
EVENT EVENT DOWNLOAD LANGUAGE 
SELECTION 

1- Envelope event download language 
selection is sent to the SIM 

2- EnvelopeHandler . getXheHandler ( ) method 
is called by Appletl 

3- EnvelopeHandler . getXheHandler ( ) method 
is called by Applet2 


1 - Appletl is triggered 

2- No exception is thrown. 
Appletl finalizes 

3- Applet2 is triggered 

4- No exception is thrown. 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


19 


Envelope Handler availability with 
EVENT EVENT DOWNLOAD BROWSER 
TERIMINATION 

1- Envelope event download browser 
termination is sent to the SIM 

2- EnvelopeHandler . getXheHandler ( ) method 
is called by Appletl 

3- EnvelopeHandler . getXheHandler ( ) method 
is called by Applet2 


1 - Appletl is triggered 

2- No exception is tlirown. 
Appletl finalizes 

3- Applet2 Is triggered 

4- No exception Is thrown. 




20 


Envelope Handler avallalblllty with 
EVENT_STATUS_COMMAND 

1- Status command is sent to the SIM 

2- EnvelopeHandler . getXheHandler ( ) method 
is called by Appletl 

3- EnvelopeHandler . getXheHandler ( ) method 
is called by Applet2 


1 - Appletl Is triggered 

2- A Toolkit exception 
HANDLER_NOT_AVAILABLE Is 
thrown 

Appletl finalizes 

3- Applet2 Is triggered 

4- A Toolkit exception 
HANDLER_NOT_AVAILABLE Is 
thrown 




21 


Envelope Handler availability with EVENT 
UNRECOGNIZED_ENVELOPE 

1- An unrecognized Envelope is sent to the 
SIM 

2- EnvelopeHandler . getXheHandler ( ) method 
is called by Appletl 

3- EnvelopeHandler . getXheHandler ( ) method 
is called by Applet2 


1 - Appletl Is triggered 

2- No exception Is thrown. 
Appletl finalizes 

3- Applet2 Is triggered 

4- No exception Is thrown. 





6.3.1.3.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19 


CRRC1 


1,20 



6.3.1.4 EnvelopeResponseHandler 

Test Area Reference: FWK_MHA_ ERHD. 
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6.3.1.4.1 Conformance Requirement 

6.3.1.4.1.1 Normal Execution 

• CRRNl: The handler is available for all triggered toolkit applets from the invocation of the processTooUdt 
method of the tooUdt applet until a toolkit applet has posted an envelope response or the first invocation of the 
ProactiveHandler.send method for the following events:. 

EVENT_FORMATTED_SMS_PP_ENV 

EVENT_UNFORMATTED_SMS_PP_ENV 

EVENT_CALL_CONTROL 

EVENT_SMS_MO_CONTROL 

EVENT_UNRECOGNIZED_ENVELOPE 

• CRRN2: After a call to the post method the handler is not longer available 

• CRRN3: After a call to the send method the handler is not longer available 

6.3.1 .4.1 .2 Parameters error 

No requirements. 

6.3.1 .4.1 .3 Context Errors 

• CRRCl : The handler is not available for the following events: 

EVENT_UNFORMATTED_SMS_CB 
EVENT_MENU_SELECTION 

EVENT_MENU_SELECTION_HELP_REQUEST 

EVENT_TIMER_EXPIRATION 

EVENT_EVENT_DOWNLOAD_MT_CALL 

EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED 

EVENT_EVENT_DOWNLOAD_LOCATION_STATUS 

EVENT_EVENT_DOWNLOAD_USER_ACTIVlTY 

EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 

EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 

EVENT_STATUS_COMMAND 

EVENT_PROFILE_DOWNLOAD 

6.3.1.4.2 Test Suite Files 

Test Script: FWK_MHA_ ERHD_1 .scr 

Test Applet: FWK_MHA_ ERHD_1 .Java 

FWK_MHA_ERHD_2.java 
Load Script: FWK_MHA_ ERHD_1 .Idr 
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Cleanup Script: FWK_MHA_ ERHD_1 .clr 

Parameter File: FWK_MHA_ ERHD_1 .par 



6.3.1.4.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Toolkit Appletl and Toolkit Applet2 
registration and Envelope Response Handler 
availability with 
EVENT_PROFILE_DOWNLOAD 

1- Appletl Toolkit 1 is registered to all 
events defined in [7] . 

Using the methods initMenuEntry ( ) for 
EVENT_MENU_SELECTION, 
requestPollInterval ( ) for 

EVENT_STATUS_COMMAND, allocateTimer ( ) for 
EVENT_TIMER_EXPIRATION and setEventList ( ) 
for the rest of the events. 

Applet2 Toolkit 2 is registered to 
EVENT_UNFORMATTED_SMS_PP_ENV and 
EVENT_UNRECOGNIZED_ENVELOPE . 

2- Terminal Profile command is sent to SIM 
without the facility of SET_EVENT_LIST 

, SETUP_IDLE_MODE_TEXT, SETUP_MENU and 
POLL_INTERVAL. 

Appletl is triggered 

32-EnvelopeResponseHandler . getXheHandler ( ) 

method is called by Appletl 

Appletl is deregistered to 
EVENT_PROFILE_DOWNLOAD 


1 - No exception is ttirown 

2- Appletl is triggered 

3- A Tooll<it exception 
HANDLER_NOT_AVAILABLE is 
ttirown 




2 


Envelope Response IHandler availability with 
EVENT_MENU_SELECTION_HELP_REQUEST 

Perform SIM initialization with all the 
facilities supported 

1- Envelope menu selection with help 
request is sent to the SIM 

2- EnvelopeResponseHandler . getXheHandler ( ) 
method is called by Appletl 


1- Appletl is triggered. 

2- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown 




3 


Envelope Response Handler availability with 
EVENT_MENU_SELECTION 

1- A envelope menu selection is sent to the 
SIM 

The Appletl is triggered 

2- EnvelopeResponseHandler . getXheHandler ( ) 
method is called by Appletl 


1 - Appletl is triggered 

2- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


4 


Envelope Response Handler availability with 
EVENT_UNFORMATTED_CB 

1- Envelope cell broadcast unformatted is 

2- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 


1- Appletl is triggered. 

2- A Tooll<it exception 
HANDLER_NOT_AVAILABLE is 
thrown 




5 


Envelope Response Handler availability with 
EVENT_TIMER_EXPIRATION 

1- Envelope Timer Expiration is sent to the 
S IM 

2- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 


1- Appletl is triggered. 

2- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown 




6 


Envelope Response Handler availability with 
EVENT_EVENT_DOWNLOAD_MT_CALL 

1- Envelope event download mt call is sent 
to the SIM 

2- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 


1- Appletl is triggered. 

2 -A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown 




7 


Envelope Response Handler availability with 
EVENT EVENT DOWNLOAD CALL CONNECT 
ED 

1- Envelope event download call connected 
is sent to the SIM 

2- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 


1- Appletl is triggered. 

2- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown 




8 


Envelope Response Handler availability with 
EVENT EVENT DOWNLOAD CALL DISCONN 
ECTED 

1- Envelope event download call 

2- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 


1- Appletl is triggered. 

2- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


9 


Envelope Response Handler availability with 
EVENT EVENT DOWNLOAD LOCATION STA 
TUS 

1- Envelope event download location status 
is sent to the SIM 

2- Applet A obtains the Envelope Response 
Handler 


1- Appletl is triggered. 

2- A Tooll<it exception 
HANDLER_NOT_AVAILABLE is 
thrown 




10 


Envelope Response Handler availability with 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

1- Envelope event download user activity is 
osnt to tils oJ.r'i 

2- EnvelopeResponseHandler . getXheHandler ( ) 
method is called by Appletl 


1- Appletl is triggered. 

2- A Tooll<it exception 
HANDLER_NOT_AVAILABLE is 
tlirown 




11 


Envelope Response Handler availability with 
EVENT EVENT DOWNLOAD IDLE SCREEN 
AVAILABLE 

1- Envelope event download idle screen 
available is sent to the SIM 

2- EnvelopeResponseHandler . getXheHandler ( ) 
method is called by Appletl 


1- Appletl is triggered. 

2- A Tooll<it exception 
HANDLER_NOT_AVAILABLE is 
thrown 




12 


Envelope Response Handler availability with 
EVENT EVENT DOWNLOAD CARD READER 
_STATUS 

1- Envelope event download card reader 
status is sent to the SIM 

2- EnvelopeResponseHandler . getXheHandler ( ) 
method is called by Appletl 


1 - Appletl is triggered 

2- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown 




13 


Envelope Response Handler availability with 
EVENT_STATUS_COMMAND 

1- Status command is sent to the SIM 

2- EnvelopeResponseHandler . getXheHandler ( ) 
method is called by Appletl 


1 - Appletl is triggered 

2- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown 
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Id 



Description 



API/Framework Expectation 



APDU Expectation 



14 



Envelope Response Handler availability witli 
EVENT FORMATTED SMS PP ENV 



l-A formatted sms pp envelope is sent to 
the SIM 



2- EnvelopeResponseHandler . getXheHandler ( ) 

method is called by Appletl 

3- Appletl builds an additional information 
for response packet and it calls the post 

method 

4- Appletl calls all methods of the 
Envelope Response Handler (including the 
inherited method) 

The Appletl finalizes 

5- A EVENT_FORMATTED_SMS_PP_ENV envelope is 
sent to the SIM 



5-EnvelopeResponseHandler . getXheHandler ( ) 
method is called by Appletl 

7- Appletl builds a proactive command and 
it calls the sendO method 

8- Appletl calls all methods of the 
Envelope Response Handler (including the 
inherited method) 



1 - Appletl is triggered 



2- No exception is tlirown. 



3- The response pacl<et is 
sent 



4- A Tooll<it exception 
HANDLER_NOT_AVAILABLE is 
tlirown for each method 



5- Appletl is triggered 



6- No Exception is thrown 



8- Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown for each method 



7- The proactive command 
is sent 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


15 


Envelope Response Handler availability with 
EVENT_UNFORMATTED_SMS_PP_ENV 

1- A unformatted sms pp envelope is sent to 

the SIM 

2- EnvelopeResponseHancller . getTheHandler ( ) 
method is called by Applet 1 


1 - Appletl is triggered 
2- No exception is thrown. 






3- Appletl builds the envelope response and 

it calls the postO method 

4- Appletl calls all methods of the 
Envelope Response Handler (including the 
inherited method) 


4- A Tooll<it exception 
HANDLER_NOT_AVAILABLE is 
thrown for each method 


3- The envelope response is 
sent 




The Appletl finalizes 


5- Applet2 is triggered. 






5-EnvelopeResponseHandler . getTheHandler ( ) 
method is called 

Applet2 finalizes. 


6- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown. 






5-A unformatted sms pp envelope is sent to 
the SIM 


7- Appletl is triggered 






7-EnvelopeResponseHandler . getTheHandler ( ) 
method is called. 


8- No exception is thrown. 






8- Appletl builds a proactive command and 
it calls the sendO method 

9- Appletl calls all methods of the 
Envelope Response Handler (including the 
inherited method) 


1 0- A Toolkit exception 

I 1 A K 1 l~N 1 1 — r~> K 1 /~V"T" At/All Am n~ 

HANDLER NOT AVAILABLE is 
thrown for each method 

Appletl finalizes 

I I - Applet2 is triggered 


9- The proactive command 
is fetched and the Terminal 
response is issued. 




10-EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Applet2 


1 2- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


16 


Envelope Response Handler availability with 
EVENT_CALL_CONTROL_BY_SIM 

1- Envelope call control by sim is sent to 

the SIM 

2- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Applet 1 

3- Appletl builds the envelope response and 
it calls the postAsBERTLV ( ) method 

4- Appletl calls all methods of the 
Envelope Response Handler (including the 

inherited method) 

The Appletl finalizes 

5- Envelope call control by sim is sent to 
the SIM 

6- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 

7- Appletl builds a proactive command and 
it calls the sendO method 

8- Appletl calls all methods of the 
Envelope Response Handler (including the 
inherited method) 


1 - Appletl is triggered 
2- No exception is tlirown. 

4- Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown for each method 

5- Appletl is triggered 

6- No Exception is thrown 

8- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown for each method 


3- The envelope response is 
sent 

7- The proactive command 
is fetched and the Terminal 
response is issued 


17 


Envelope Response Handler availability with 
EVENT MO SHORT lUIESSAGE CONTROL B 
Y_SIM 

1- Envelope mo short message control by sim 

is sent to the SIM 

2- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Appletl 

3- Appletl builds the envelope response and 
it calls the postAsBERTLV ( ) method 

4- Appletl calls all methods of the 
Envelope Response Handler (including the 
inherited method) 

The Appletl finalizes 

5- Envelope mo short message control by sim 
is sent to the SIM 

6- EnvelopeResponseHandler . getTheHandler ( ) 

method is called by Appletl 

7- Appletl builds a proactive command and 
it calls the send method 

8- Appletl calls all methods of the 
Envelope Response Handler (including the 
inherited method) 


1 - Appletl is triggered 
2- No exception is thrown. 

4- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown for each method 

5- Appletl is triggered 

6- No exception is thrown 

8- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown for each method 


3-The envelope response is 
sent 

7- The proactive command 
is fetched and the Terminal 
Response is issued 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


18 


Envelope Response Handler availability with 
EVENT_UNRECOGNIZED_ENVELOPE 

1- An unrecognized Envelope is sent to the 

SIM 

2- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Applet 1 


1 - Appletl is triggered 
2- No exception is thrown. 






3- Appletl builds the envelope response and 
it calls the postAsBERTLV ( ) or post method 

4- Appletl calls all methods of Envelope 
Response Handler (including the inherited 

method) 

The Appletl finalizes 


4- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown for each method 

5- Applet2 is triggered. 


3- The envelope response is 
sent 




54-EnvelopeResponseHandler . getTheHandler ( ) 
method is called 

Applet2 finalizes 


6- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown for each method 






6-An unrecognized Envelope is sent to the 
SIM 


7- Appletl is triggered. 






7-EnvelopeResponseHandler . getTheHandler ( ) 

method is called 


8- No exception is thrown. 






8- Appletl builds a proactive command and 
it calls the sendO method 

9- Appletl calls all methods of the 
Envelope Response Handler (including the 
inherited method) 


I \J r\ I UUIixIl caOc[JUUi I 

HANDLER_NOT_AVAILABLE is 
thrown for each method 

Appletl finalizes 

I I - Applet2 is triggered 


9- The proactive command 
is fetched and the Terminal 
response is issued 




10-EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Applet2 


1 2- A Toolkit exception 
HANDLER_NOT_AVAILABLE is 
thrown for each method 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


19 


The envelope response is sent when a 
proactive session is ongoing 

1- A formatted SMS PP envelope is sent to 
the SIM. 

2- Proactive command DISPLAY TEXT is built 
and it calls the sendO method. 

3- A call control by sim envelope is sent 
to the SIM. 

4- EnvelopeResponseHandler . getTheHandler ( ) 
method is called by Applet 1 

5- Appletl builds the envelope response and 
it calls the postAsBERTLV 


1- Appletl is triggered. 

3- Appletl is triggered 

4- No exception is thrown 


2- 91 XX 

5-The envelope response is 

sent 

9F YY 

GET RESPONSE 
Data 

91 XX 
Fetch DISPLAY TEXT 

Terminal Response 
DISPLAY TEXT 


NOTE: Due to an inconsistency in GSM 03.1 9 [7] specification it is not possible to cover the test case when an applet 
try to post data in multitriggering. 



6.3.1 .4.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


14, 15, 16, 17, 18, 19 


CRRN2 


14, 15, 16, 17, 18, 19 


CRRN3 


14, 15, 16, 17, 18, 19 


CRRC1 


1,2,3, 4, 5, 6, 7, 8,9, 10, 11, 12, 13 



6.3.2 Handler Integrity 
6.3.2.1 ProactiveHandler 

Test Area Reference: FWK_HIN_PAHD. 

6.3.2.1.1 Conformance Requirement 

6.3.2.1.1.1 Normal Execution 

• CRRNl : At the processToolkit invocation the TLV-List is cleared. 

• CRRN2: After a call to ProactiveHandler. send method the handler will remain unchanged until the 
ProactiveHandler.init or appendTLV method are called. 

6.3.2.1 .1 .2 Parameters error 

No requirements. 
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6.3.2.1.1.3 

No requirements. 

6.3.2.1.2 

Test Script: 
Test Applet: 

Load Script: 
Cleanup Script: 
Parameter File: 



Context Errors 

Test Suite Files: 

FWK_H1N_PAHD_1 .scr 
FWK_HIN_PAHD_1 .java 
FWK_HIN_PAHD_2.java 
FWK_HIN_PAHD_1 .Idr 
FWK_HIN_PAHD_1 .clr 
FWK_HIN_PAHD_1 .par 



6.3.2.1.3 



Test Procedure 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



At the processToolkit Invocation the TLV-List 
is cleared 



Appletl and Applet2 are registered to 
EVENT_UNFORMATTED_SMS_PP_ENV . 



1-An envelope containing an unformatted 
sms pp is sent to the SIM 



2-ProactiveHandler . getLength ( ) method is 

called by Appletl 



1- Appletl is triggered. 



2- The return value is 



TLV-List change after the init method 
invocation 



ProactiveHandler . init ( ) method is called 
by Appletl 

1-ProactiveHandler . getLength ( ) method is 
called by Appletl 



1 - The return value Is 9 



The TLV-List remains unchanged after the 
send() method invocation 

l-ProactiveHandler . send ( ) method is called 
by Appletl 



2-ProactiveHandler . getLength ( ) method is 
called by Appletl 



It's checked that the content is the same 
than before the calling to send method 
using ProactiveHandler . copyValue and 
Util . arrayCompare methods 



2- The return value is 9, and Its 

contents is the same than before 
the calling to send method 



1- The proactive command 
Is fetched and the terminal 
response Is Issued. 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


4 


At the processToolkit invocation the TLV-List 
Is cleared 

1- ProactiveHandler . getLength ( ) method is 
called by Applet2 

2- ProactiveHandler . getValueLength ( ) method 
is called by Applet2 


1 - Applet2 is triggered 

2- The return value is 

3- ToolkitException 
UNAVAILABLE_ELEMENT is 
thrown 





6.3.2.1.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2, 3,4 


CRRN2 


3 



6.3.2.2 ProactiveResponseHandler 

Test Area Reference: FWK HIN PRHD 



6.3.2.2.1 
6.3.2.2.1.1 



Conformance Requirement 
Normal Execution 



• CRRNl: The ProactiveResponseHandler content is changed after the call to ProactiveHandler.send method and 
remains unchanged until next call to the ProactiveHandler.send method. 

• CRRN2: The ProactiveResponseHandler may not be available before the first call to ProactiveHandler.send 
method, if available the content is cleared. 



6.3.2.2.1.2 

No requirements. 

6.3.2.2.1.3 

No requirements. 

6.3.2.2.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 



Parameters error 
Context Errors 

Test Suite Files 

FWK_H1N_PRHD_1 .scr 
FWK_HIN_PRHD_1 .Java 
FWK_HIN_PRHD_1 .Idr 
FWK_HIN_PRHD_1 .clr 
FWK_HIN_PRHD_1 .par 
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6.3.2.2.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applet registration and 
ProactiveResponseHandler obtaining 

1- Applet is registered to all events 
defined in [ 7 ] . 

Using the methods initMenuEntry for 
EVENT_MENU_SELECTION, 
requestPollInterval ( ) for 

EVENT_STATUS_COMMAND, allocateTimer ( ) for 
EVENT_TIMER_EXPIRATION and setEventList ( ) 
for the rest of the events. 

Terminal Profile command is sent to the 
SIM without the facilities of 
SET_EVENT_LIST , SETUP_IDLE_MODE_TEXT, 
SETUP_MENU and POLL_INTERVAL . 

For each event: 

2 - ProactiveResponseHandler . getXheHandler ( ) 
is called 

If handler is available, 
ProactiveResponseHandler . getLength ( ) is 
called 


1- No exception is thrown 

2- Applet is triggered. 

3- Behaviour 1 : 
Toolkit Exception 
HANDLER_NOT_AVAILABLE is 
thrown. 

Behaviour 2: 

No exception is thrown, the return 
value is 




2 


The ProactiveResponseHandler remains 
unchanged after send method invocation until 
next send method Invocation 

1- Applet builds a proactive command 
ProactiveHandler . send ( ) method is called 

2 - ProactiveResponseHandler . getLength ( ) 
method is called 

3- ProactiveHandler . init ( ) method is called 

4- ProactiveHandler . send ( ) method is called 

5- ProactiveResponseHandler . getLength ( ) 
method is called 


1- The ProactiveResponseHandler 
contains the terminal response 

3- The return value is 12 

4- No exception is thrown and the 
Proactive Response Handler 
remains unchanged 

5- The ProactiveResponseHandler 
contains the terminal response of 
the second proactive command 

7- The return value is 15 


2- A proactive command is 
fetched 

The terminal response is sent 
with length 12 

6- A proactive command is 
fetched 

The terminal response is sent 
with length 1 5 



6.3.2.2.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


1 
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6.3.2.3 EnvelopeHandler 

Test Area Reference: FWK HIN ENHD. 



6.3.2.3.1 



6.3.2.3.1.1 



Conformance Requirement 
Normal Execution 



• CRRNl : The EnvelopeHandler and its content are available for all triggered toolkit applets, from the invocation 
to the termination of their processToolldt method. 

• CRRN2: The SIM Toolkit Framework guarantees that all triggered toolkit applets receive the data. 



6.3.2.3.1.2 

No requirements. 

6.3.2.3.1.3 

No requirements. 

6.3.2.3.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 



Parameters error 

Context Errors 

Test Suite Files 

FWK_fflN_ENHD_l .scr 
FWK_fflN_ENHD_l .Java 
FWK_HIN_ENHD_1 .Idr 
FWK_HIN_ENHD_1 .ck 
FWK_H1N_ENHD_1 .par 
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6.3.2.3.3 Test Procedure 



IH 
lu 


uescripiion 


Mri/rrafnsworK cxpsciaiion 


AKuu txpeciaiion 


1 


Applet initialization and Envelope Handler 








integrity checks with 








EVENT_MENU_SELECTION_HELP_REQUEST 








1- Applet is registered to all events 


1-No exception is thrown 






defined in [7] except 






EVENT_PROFILE_DOWNLOAD and 








EVENT_STATUS_COMMAND . 








Using the methods initMenuEntry ( ) for 








EVENT_MENU_SELECTION, allocateTimer ( ) for 
















for the rest of the events. 








Perform SIM initialization with all the 








facilities supported 








2-Envelope menu selection with help request 


2- Applet is triggered 






is sent to the SIM 










Nn PYfpntinn thrnwn 

\J I wAOwL^LIUI 1 lO 11 II \JW 1 1 ■ 






3-EnvelopeHandler . getXheHandler ( ) method is 








called 








4-Copy the contents of the envelope handler 


4- No exception is thrown 










in buffer 1 using EnvelopeHandler . copy ( ) 








The EnvelopeHandler . findXLV ( ) method is 








called with TAG_HELP_REQUEST 








5-A proactive command DISPLAY TEXT is sent 




5- 91 XX. 




6-Envelope call control by sim is sent to 


6- Applet is triggered 










SIM 








EnvelopeHandler . get TheHandler ( ) method is 








called 








7- It's checked that the contents of the 


7- No exception is thrown and the 






envelope handler is the envelope call 


handler contains the envelope call 






control using EnvelopeHandler . copy ( ) and 


control by SIM 






Util . arrayCompare ( ) methods 








The EnvelopeHandler . findTLV ( ) method is 








called with TAG_DEVICE_IDENTITIES 








Call Control execution is finished. 












A proactive command 








Display Text is fetched 








The terminal Response of 








DISPLAY TEXT is sent to 








thp SIM 

11 iXS 1 Ivl 




Check that the TAG_HELP_REQUEST is the TLV 








selected 










8- The contents of the envelope 






8-The contents of EnvelopeHandler are 


handler shall be the same as stored 






compared with bufferl using 


in buffer 1 






Util . arrayCompare ( ) 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


2 


Envelope Handler integrity checks with 
EVENT_MENU_SELECTION 

1- An envelope menu selection is sent to 
SIM 

2- EnvelopeHandler . getXheHandler ( ) method is 
called 

3- Copy the contents of the envelope handler 
in buffer 1 using EnvelopeHandler . copy ( ) 

The Envel opeHandler . f indTLV ( ) method is 
called with TAG_ITEM„IDENTIFIER 


1 - Applet is triggered 

2- No exception Is thrown. 

3- No exception Is thrown. 






4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by sim is sent to 
SIM 


5- Applet is triggered 


4-91 XX 




EnvelopeHandler . getXheHandler ( ) method is 
called 








6- It's checked the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare ( ) methods 


6- No exception Is thrown and the 

llallUlcr OUiUdlllb Ulc cilVclupc Odll 

control by SIM 






The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 








Call Control execution is finished. 








It's checked that the TAG ITEM IDENTIFIER 
is the TLV selected 




Proactive command Display 
Text is fetched 
The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 




7- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare ( ) 


7- The contents of the envelope 
handler shall be the same as stored 
In buffer 1 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


3 


Envelope Handler integrity checks with 
EVENT_FORMATTED_SMS_PP_ENV 

1- A formatted sms pp envelope is sent to 
SIM 

2- EnvelopeHandler . getXheHandler ( ) method is 
called 

3- Copy the contents of the envelope handler 
in buffer 1 using EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findXLV ( ) method is 
called with TAG_SMS_TPDU 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by sim is sent to 
SIM 

EnvelopeHandler . get TheHandler ( ) method is 

called 

6- It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare methods 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished. 

It's checked that the TAG_SMS_TPDU is the 
TLV selected 

7- The contents of EnvelopeHandler are 
compared with bufferl using 

Util . arrayCompare ( ) 


1 - Applet is triggered 

2- No exception is thrown. 

3- No exception is tiirown. 

5- Applet is triggered 

6- No exception is tiirown and the 
handler contains the envelope call 
control by SIM 

7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 


4-91 XX 

Proactive command Display 
Text is fetched 
The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 



ETSI 



3GPP TS 11.13 version 8.2.1 Release 1999 



309 



ETSI TS 101 955 V8.2.1 (2003-04) 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


A 

^■ 


envelope riariQisr inisyriiy cnscKS wiin 








EVENT_FORMATTED_SMS_CB 








l-An envelope SMS-CB formatted according to 


1 - Applet is triggered 






[8] is sent to the SIM 








2-EnvelopeHandler . getXheHandler ( ) method is 


2-No exception is tlirown. 






called 






3-Copy the contents of the envelope handler 








in buffer 1 using EnvelopeHandler . copy ( ) 


3-No exception is thrown. 






The EnvelopeHandler . findlLV ( ) method is 
















4-A proactive command DISPLAY TEXT is sent 












4-91 XX 




5-Envelope call control by sim is sent to 








SIM 










5- Applet is triggered 






EnvelopeHandler . getTheHandler ( ) method is 








called 








6-It's checked that the contents of the 








envelope handler is the envelope call 








control using EnvelopeHandler . copy ( ) and 








Util . arrayCompare ( ) methods 


6- No exception is thrown and the 










The EnvelopeHandler . findTLV ( ) method is 


handler contains the envelope call 






called with TAG_DEVICE_IDENTITIES 


control by SIM 






Call Control execution is finished. 












rroacTive commana uispiay 








Text is fetched 








The terminal Response of 




It's checked that the 




DISPLAY TEXT is sent to 




TAG_CELL_BROADCAST_PAGE is the TLV selected 




the SIM 




7- The contents of EnvelopeHandler are 








compared with bufferl using 








Util . arrayCompare ( ) 










7- The contents of the envelope 








handler shall be the same as stored 








in buffer 1 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


5 


Envelope Handler integrity checks with 
EVENT_UNFORMATTED_SMS_PP_ENV 

1- A unformatted sms pp envelope is sent to 
SIM 

2- EnvelopeHandler . getXheHandler ( ) method is 
called 

3- Copy the contents of the envelope handler 
in buffer 1 using EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV method is 
called with TAG_DEVICE_IDENTITIES 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by sim is sent to 
SIM 

EnvelopeHandler . getXheHandler ( ) method is 
called 

6- It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 

Util . arrayCompare ( ) methods 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished. 

It's checked that the TAG_DEVICE_IDENTITIES 
is the TLV selected 

7- The contents of EnvelopeHandler are 
compared with bufferl using 

Util . arrayCompare ( ) 


1 - Applet is triggered 

2- No exception is thrown. 

3- No exception is tlirown. 

5- Applet is triggered 

6- No exception is tiirown and the 
handler contains the envelope call 
control by SIM 

7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 . 


4-91 XX 

Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


6 


Envelope Handler integrity checks with 








PUPNT 1 INPrtRMATTPn QMQ PR 








1-A unformatted cellbroadcast envelope is 


1 - Applet is triggered 






sent to SIM 








2-EnvelopeHandler . getXheHandler ( ) method is 


2- No exception is thrown. 






called 








3-Copy the contents of the envelope handler 


3- No exception is tlirown. 






in buffer 1 using EnvelopeHandler . copy ( ) 






The EnvelopeHandler . findTLV ( ) method is 








called with TAG_CELLBROADCAST_PAGE 












4- 91 XX 




4-A proactive command DISPLAY TEXT is sent 








5-Envelope call control by sim is sent to 


5- Applet is triggered 










SIM 








EnvelopeHandler . getTheHandler ( ) method is 








called 










6- No exception is tlirown and tiie 






6-It's checked that the contents of the 


handler contains the envelope call 






envelope handler is the envelope call 


rnntrnl hv RIM 






control using EnvelopeHandler . copy and 






Ut 11 . ar rayCompare ( ) methods 








The EnvelopeHandler . findTLV ( ) method is 








called with TAG_DEVICE_IDENTITIES 








Call Control execution is finished. 












Proactive command Display 








Text is fetched 








The terminal Response of 








DISPLAY TEXT is sent to 








the SIM 




It's checked that the 








TAG_CELLBROADCAST_PAGE is the TLV selected 


7- The contents of the envelope 












7- The contents of EnvelopeHandler are 


handler shall be the same as stored 






compared with bufferl using 


in buffer 1 . 






Util . arrayCompare ( ) 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


7 


Envelope Handler integrity checks with 
EVENT_TIMER_EXPIRATION 

1- A timer expiration envelope is sent to 
SIM 

2- EnvelopeHandler . getXheHandler ( ) method is 
called 

3-Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_TIMER_ID 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by sim is sent to 
SIM 

EnvelopeHandler . getTheHandler ( ) method is 
called 

6- It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare ( ) methods 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished. 

It's checked that the TAG_TIMER_IDE is the 
TLV selected 

7- The contents of EnvelopeHandler are 
compared with bufferl using 

Util . arrayCompare ( ) 


1 - Applet is triggered 

2- No exception is thrown. 

3- No exception is tlirown. 

5- Applet is triggered 

6- No exception is tiirown and the 
handler contains the envelope call 
control by SIM 

7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 


4- 91 XX 

Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


8 


Envelope Handler integrity checks with 
EVENT_CALL_CONTROL_BY_SIM 

1- A call control envelope is sent to SIM 

2- EnvelopeHandler . getXheHandler ( ) method is 
called 

3-Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_ADDRESS 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by sim is sent to 
SIM 

EnvelopeHandler . getTheHandler ( ) method is 
called 

6- It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare ( ) methods 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished. 

It ' s checked that the TAG_ADDRESS is the 
TLV selected 

7- The contents of EnvelopeHandler are 
compared with bufferl using 

Util . arrayCompare ( ) 


1 - Applet is triggered 

2- No exception is thrown. 

3- No exception is tlirown. 

5- Applet is triggered 

6- No exception is tiirown and the 
handler contains the envelope call 
control by SIM 

7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 


4- 91 XX 

Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 
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Id 



Description 



APi/FrameworIc Expectation 



APDU Expectation 



Envelope Handler integrity checl(S witli EVENT_ 
MO_SHORT_MESSAGE_CONTROL_BY_SIM 

l-A mo short message control by sim 
envelope is sent to SIM 



2-EnvelopeHandler . getXheHandler ( ) method is 
called 



3-Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_ADDRESS 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by sim is sent to 

SIM 

EnvelopeHandler . getTheHandler ( ) method is 
called 

6- It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare ( ) methods 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished. 



It ' s checked that the TAG_ADDRESS is the 
TLV selected 

7- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare ( ) 



1 - Applet is triggered 



2- No exception is thrown. 



3- No exception is thrown. 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by SIM 



4- 91 XX 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 



7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 . 
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Id 


Description 


API/Frameworl( Expectation 


APDU Expectation 


10 


Envelope Handler integrity checl(S witli EVENT_ 








PUPNT nnWNI DAD MT PAI 1 








1-A event download mt call envelope is sent 


1 - Applet is triggered 






to SIM 








2-EnvelopeHandler . getXheHandler ( ) method is 


P- Mn PYPPntinn iq thm\A/n 






called 








3-Copy the contents of the envelope handler 


3- No exception is thrown. 






in buffer 1 using EnvelopeHandler . copy ( ) 














called with TAG_ADDRESS 








4-A proactive command DISPLAY TEXT is sent 




4- 91 XX 




5-Envelope call control by sim is sent to 








S IM 


5- Applet Is triggered 






EnvelopeHandler . getTheHandler ( ) method is 








called 








6-It's checked that the contents of the 








envelope handler is the envelope call 


6- No exception is thrown and the 






control using EnvelopeHandler . copy ( ) and 


handlpr mntain^ thp pnvplonp rail 






Util . arrayCompare ( ) methods 


control by SIM 






The EnvelopeHandler . findTLV ( ) method is 








called with TAG_DEVICE_IDENTITIES 








Call Control execution is finished. 












Proactive command Display 








Text is fetched 








The terminal Response of 








DISPLAY TEXT is sent to 




It ' s checked that the TAG_ADDRESS is the 




the SIM 




TLV selected 








7- The contents of EnvelopeHandler are 








compared with bufferl using 


7- The contents of the envelope 






Util . arrayCompare ( ) 


handler shall be the same as stored 








in buffer 1 
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Id 


Description 


API/Frameworl( Expectation 


APDU Expectation 


11 


Envelope Handler integrity checl(S witli EVENT 
EVENT_DOWNLOAD_CALL_CONNECTED 

1- A event download call connected envelope 
is sent to SIM 

2- EnvelopeHandler . getXheHandler ( ) method is 
called 

3-Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_ADDRESS 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by sim is sent to 
SIM 

EnvelopeHandler . getTheHandler ( ) method is 

called 

6- It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy and 
Util . arrayCompare ( ) methods 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished. 

It ' s checked that the TAG_ADDRESS is the 
TLV selected 

7- The contents of EnvelopeHandler are 
compared with bufferl using 

Util . arrayCompare ( ) 


1 - Applet is triggered 

2- No exception is thrown. 

3- No exception is thrown. 

5- Applet is triggered 

6- No exception is thrown and the 
handler contains the envelope call 
control by SIM 

7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 . 


4- 91 XX 

Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 
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Id 


Description 


API/Frameworl( Expectation 


APDU Expectation 


12 


Envelope Handler integrity checl(S with EVENT 
EVENT_DOWNLOAD_CALL_DISCONNECTED 

1- A event download call disconnected 
envelope is sent to SIM 

2- EnvelopeHandler . getXheHandler ( ) method is 
called 

3-Copy the contents of the envelope 
handler in buffer 1 using 
EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_ADDRESS 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by sim is sent to 
SIM 

EnvelopeHandler . getTheHandler ( ) method is 
called 

6- It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy and 
Util . arrayCompare ( ) methods 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished. 

It ' s checked that the TAG_ADDRESS is the 
TLV selected 

7- The contents of EnvelopeHandler are 
compared with bufferl using 

Util . arrayCompare ( ) 


1 - Applet is triggered 

2- No exception is thrown. 

3- No exception is thrown. 

5- Applet is triggered 

6- No exception is thrown and the 
handler contains the envelope call 
control by SIM 

7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 . 


4- 91 XX 

Proactive command Display 
Text is fetched 
The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 
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Id 



Description 



APi/FrameworIc Expectation 



APDU Expectation 



13 



Envelope Handler integrity checl(S witli EVENT_ 
EVENT_DOWNLOAD_LOCATiON_STATUS 

l-A event download location status envelope 
is sent to SIM 



2-EnvelopeHandler . getXheHandler ( ) method is 
called 



3- Copy the contents of the envelope handler 
in buffer 1 using EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_LOCATION_STATUS 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by sim is sent to 
SIM 



EnvelopeHandler . getTheHandler ( ) method is 
called 

6-It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare ( ) methods 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished. 



1 - Applet is triggered 



2- No exception is thrown. 



3- No exception is thrown. 



It's checked that the TAG_LOCATION_STATUS 
is the TLV selected 

7- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare ( ) 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by SIM 



4-91 XX 



Proactive command Display 
Text is fetched 

The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 



7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 
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Id 



Description 



APi/FrameworIc Expectation 



APDU Expectation 



14 



Envelope Handler integrity checl(S witli EVENT_ 
EVENT_DOWNLOAD_USER_ACTIViTY 

l-A event download user activity envelope 
is sent to SIM 



2-EnvelopeHandler . getXheHandler ( ) method is 
called 



3- Copy the contents of the envelope handler 
in buffer 1 using EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 

4- A proactive command DISPLAY TEXT is sent 

5- Envelope call control by sim is sent to 
SIM 



EnvelopeHandler . getTheHandler ( ) method is 
called 

6-It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare ( ) methods 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 

Call Control execution is finished. 



1 - Applet is triggered 



2- No exception is thrown. 



3- No exception is thrown. 



5- Applet is triggered 



6- No exception is thrown and the 
handler contains the envelope call 
control by SIM 



It's checked that the TAG_DEVICE_IDENTITIES 
is the TLV selected 

7- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare ( ) 



4- 91 XX 



Proactive command Display 
Text is fetched 



The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 



7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


15 


Envelope Handler integrity checl(S witli EVENT 
EVENT DOWNLOAD IDLE SCREEN AVAILAB 
LE 

1- A event download idle screen available 
envelope is sent to SIM 

2- EnvelopeHandler . getXheHandler ( ) method is 
called 

3- Copy the contents of the envelope handler 
in buffer 1 using EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 

4- A proactive command DISPLAY TEXT is sent 


1 - Applet is triggered 

2- No exception is thrown. 

3- No exception is thrown. 






5-Envelope call control by sim is sent to 
SIM 


5- Applet is triggered 


4-91 XX 




EnvelopeHandler . get TheHandler ( ) method is 
called 








6-It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare ( ) methods 


6- No exception is thrown and the 
handler contains the envelope call 
control by SIM 






The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 








Call Control execution is finished. 




Proactive command Display 
Text is fetched 




It's checked that the TAG_DEVICE_IDENTITIES 
is the TLV selected 




The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 




7- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare ( ) 


7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 
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Id 


Description 


API/Frameworl( Expectation 


APDU Expectation 


16 


Envelope Handler integrity checl(S witli EVENT 
EVENT_DOWNLOAD_CARD_READER_STATUS 

1- A event download card reader status 
envelope is sent to SIM 

2- EnvelopeHandler . getXheHandler ( ) method is 
called 

3- Copy the contents of the envelope handler 
in buffer 1 using EnvelopeHandler . copy ( ) 

The EnvelopeHandler . fmdTLV ( ) method is 
called with TAG_CARD_READER_STATUS 

4- A proactive command DISPLAY TEXT is sent 


1 - Applet is triggered 

2- No exception is thrown. 

3- No exception is thrown. 






5-Envelope call control by sim is sent to 
SIM 


5- Applet is triggered 


4-91 XX 




EnvelopeHandler . getTheHandler ( ) method is 

called 








6-It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy and 
Util . arrayCompare ( ) methods 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 


6- No exception is thrown and the 
handler contains the envelope call 
control by SIM 


Proactive command Display 
Text is fetched 




It's checked that the 

TAG_CARD_READER_STATUS is the TLV selected 




The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 




7- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare ( ) 


7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


17 


Envelope Handler integrity checks with 
EVENT EVENT DOWNLOAD LANGUAGE SEL 
ECTION 

1- A event download language selection 
envelope is sent to SIM 

2- EnvelopeHandler . getXheHandler ( ) method is 
called 

3- Copy the contents of the envelope handler 
in buffer 1 using EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_EVENT_LIST 

4- A proactive command DISPLAY TEXT is sent 


1 - Applet is triggered 

2- No exception is thrown. 

3- No exception is thirown. 






5-Envelope call control by sim is sent to 
SIM 


5- Applet Is triggered 


4-91 XX 




EnvelopeHandler . get TheHandler ( ) method is 
called 








6-It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare ( ) methods 


6- No exception is thrown and the 
handler contains the envelope call 
control by SIM 






The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 








Call Control execution is finished. 




Proactive command Display 
Text is fetched 




It's checked that the TAG_EVENT_LIST is the 
TLV selected 




The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 




7- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare ( ) 


7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


18 


Envelope Handler integrity checks with 
EVENT EVENT DOWNLOAD BROWSER TERM 
INATION 

1- A event download browser termination 
envelope is sent to SIM 

2- EnvelopeHandler . getXheHandler ( ) method is 
called 

3- Copy the contents of the envelope handler 
in buffer 1 using EnvelopeHandler . copy ( ) 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_EVENT_LIST 

4- A proactive command DISPLAY TEXT is sent 


1 - Applet is triggered 

2- No exception is thrown. 

3- No exception is thrown. 






5-Envelope call control by sim is sent to 
SIM 


5- Applet is triggered 


4-91 XX 




EnvelopeHandler . get TheHandler ( ) method is 
called 








6-It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare ( ) methods 


6- No exception Is thrown and the 
handler contains the envelope call 
control by SIM 






The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 








Call Control execution is finished. 




Proactive command Display 
Text is fetched 




It's checked that the TAG_EVENT_LIST is the 
TLV selected 




The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 




7- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare ( ) 


7- The contents of the envelope 
handler shall be the same as stored 
in buffer 1 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


19 


Envelope Handler integrity checks with 
UNRECOGNIZED_ENVELOPE 

1- A unrecognized envelope is sent to SIM 

2- EnvelopeHandler . getTheHandler ( ) method is 
called 

3- Copy the contents of the envelope handler 
in buffer 1 using EnvelopeHandler . copy ( ) 

4- A proactive command DISPLAY TEXT is sent 


1 - Applet is triggered 

2- No exception Is thrown. 

3- No exception Is thrown. 






5-Envelope call control by sim is sent to 
SIM 

EnvelopeHandler . getTheHandler ( ) method is 

called 

The EnvelopeHandler . getValueLength ( ) is 
called 


5- Applet Is triggered 


4- 91 XX 




6-It's checked that the contents of the 
envelope handler is the envelope call 
control using EnvelopeHandler . copy ( ) and 
Util . arrayCompare ( ) methods 

The EnvelopeHandler . findTLV ( ) method is 
called with TAG_DEVICE_IDENTITIES 


6- No exception Is thrown and the 
handler contains the envelope call 
control by SIM 






Call Control execution is finished. 




Proactive command Display 
Text Is fetched 




7- The contents of EnvelopeHandler are 
compared with bufferl using 
Util . arrayCompare ( ) 


7- The contents of the envelope 
handler shall be the same as stored 
In buffer 1 


The terminal Response of 
DISPLAY TEXT is sent to 
the SIM 



6.3.2.3.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19 


CRRN2 


1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15, 16, 17, 18, 19 



6.3.3 Applet Triggering 

6.3.3.1 EVENT_PROFILE_DOWNLOAD 

Test Area Reference: FWK_APT_EPDW. 

6.3.3.1.1 Conformance Requirement 

6.3.3.1.1.1 Normal Execution 

• CRRNl : Upon the reception of Terminal Profile command by the SIM, the STF stores the ME Profile and then 
triggers the registered toolkit applets. 
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• CRRN2: The applet is not triggered by the EVENT_PROFILE_DOWNLOAD once it has deregistered from this 
event. 

• CRRN3: The STF shall not reply busy to a Terminal Profile command 



6.3.3.1.1.2 

No requirements. 

6.3.3.1.1.3 

No requirements. 

6.3.3.1.2 

Test Script: 
Test Applet: 



Load Script: 
Cleanup Script: 
Parameter File: 

6.3.3.1.3 



Parameters error 

Context Errors 

Test Suite Files 

FWK_APT_EPDW_1 .scr 
FWK_APT_EPDW_1 .java 
FWK_APT_EPDW_2.java 
FWK_APT_EPDW_3.java 
FWK_APT_EPDW_1 .Idr 
FWK_APT_EPDW_1 .ck 
FWK_APT_EPDW_1 .par 

Test Procedure 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



Applets registration to 
EVENT_PROFILE_DOWNLOAD and triggering 

Appletl is registered to the 
EVENT„PROFILE_DOWNLOAD 

Applet2 is registered to the 
EVENT_PROFILE_DOWNLOAD 

Applets is not registered to the 
EVENT_PROFILE_DOWNLOAD and is registered 
to EVENT_FORMATTED_SMS_PP_ENV. 

1-Terminal Profile command is sent to SIM 



1 - Appletl is triggered 



Appletl finalizes 

2- Applet2 is triggered 

Applet2 finalizes 

3- Applets Is not triggered 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


2 


The STF shall not reply busy to a Terminal 
Profile command 

l-Formatted sms pp envelope is sent to SIM 


1- Applet3 is triggered by tlie 
EVENT FORMATTED SMS PP 
ENV 






Applst3 builds ci REFRESH p2ro3ctivs commcind 
in sim initialization mode 

2-ProactiveHandler . send ( ) method is called 
by applets 


Applet3 is suspended until the 
terminal response 


2- A proactive command is 
sent 




3-Terminal Profile command is sent to SIM 


3- Appletl is triggered by 
EVENT_PROFILE_DOWNLOAD 






Appletl calls Toolkit Registry . clearEvent ( 
EVENT_PROFILE_DOWNLOAD) 








4-Applet2 calls Toolkit 
Registry . clearEvent ( 
EVENT_PROFILE_DOWNLOAD) 


Appletl finalizes 

4- Applet2 is triggered by 

EVENT_PROFILE_DOWNLOAD 


The terminal Response of 
the proactive command is 
sent 




ToolkitRegistry . setEvent (EVENT_PROFILE_DOW 
NLOAD) method is called 


Applet2 finalizes 
Applet3 finalizes 




3 


Dereglstered applets are not triggered 

Terminal Profile command is sent to SIM 


Applet3 is triggered 
(Appletl and Applet2 are not 
triggered) 





6.3.3.1.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1 


CRRN2 


3 


CRRN3 


2 



6.3.3.2 EVENT_MENU_SELECTION 

Test Area Reference: FWK_APT_EMSE. 

6.3.3.2.1 Conformance Requirement 

6.3.3.2.1.1 Normal Execution 

• CRRN 1 : The applet is triggered by the EVENT_MENU_SELECTION when an Envelope Menu Selection is 
received with the item identifier of a menu entry of this applet if no proactive session is ongoing. 
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6.3.3.2.1.2 

No requirements. 

6.3.3.2.1.3 

No requirements. 

6.3.3.2.2 

Test Script: 
Test Applet: 

Load Script: 
Cleanup Script: 
Parameter File: 



Parameters error 

Context Errors 

Test Suite Files 

FWK_APT_EMSE_1 .scr 
FWK_APT_EMSE_1 .Java 
FWK_APT_EMSE_2.java 
FWK_APT_EMSE_1 .Idr 
FWK_APT_EMSE_l.clr 
FWK_APT_EMSE_1 .par 
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6.3.3.2.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applet registration to 








EVENT_MENU_SELECTION and triggering 








ToolkitRegistry . initMenuEntry ( ) method is 








called, in the const iructoir of applet 1 and 








Applet 2. 








For appletl : 








MenuEnt ry= "Applet 1 " 








Offset=0 








Length=menuEntry . length 


1 1 1 IXS 1 1 Idl IDLI 1 1 lUOL 1 ClUI 1 1 11 UC 






HelpSupported=f alse 








I conQualif ie2r=0 








Iconldentif ier=0 








For applet2: 








MenuEnt ry=" Applet 2 " 








Offset=0 








Length=menuEntry . length 








HelpSupported=f alse 








IconQualif ier=0 








Iconldentif ier=0 








event= EVENT_MENU_SELECTION 








1-ToolkitRegistry . isEventSet ( ) is called 








in constructor. 








Perform SIM initialization the facility 








SET UP MENU and without the facilities SET 








EVENT LIST and POLL INTEVAL features 










2- Appletl is triggered and applet2 






2-Item Identifier = 1 


is not triggered 






Event Menu Selection envelope is sent to 






the SIM with the item identifier of a menu 








entry of applet 










Appletl finalizes 








3- Applet2 is triggered and appletl 






3-Item Identifier = 2 


is not triggered 






Event Menu Selection envelope is sent to 








the SIM with the item identifier of a menu 








entry of applet 







6.3.3.2.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1 



6.3.3.3 EVENT_MENU_SELECTION_HELP_REQUEST 

Test Area Reference: FWK_APT_EMSH. 

6.3.3.3.1 Conformance Requirement 

6.3.3.3.1.1 Normal Execution 

• CRRNl : If and ENVELOPE (MENU_SELECTION_HELP_SUPPORTED) command is received for one entry 
supporting help, then STF shall trigger the corresponding applet. 
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6.3.3.3.1.2 

No requirements. 

6.3.3.3.1.3 

No requirements. 

6.3.3.3.2 

Test Script: 
Test Applet: 

Load Script: 
Cleanup Script: 
Parameter File: 



Parameters error 

Context Errors 

Test Suite Files 

FWK_APT_EMSH_1 .scr 
FWK_APT_EMSH_1 .Java 
FWK_APT_EMSH_2.java 
FWK_APT_EMSH_1 .Idr 
FWK_APT_EMSH_1 .clr 
FWK_APT_EMSH_1 .par 



6.3.3.3.3 



Test Procedure 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



Applet registration to 
EVENT_MENU_SELECTION_HELP_REQUEST 
and triggering 

ToolkitRegistry . InitMenuEntry ( ) method is 
called in the constructor of appletl and 
Applet2 . 

For Appletl: 
MenuEnt ry= "Applet 1 " 
Offset=0 

Length=menuEntry . length 
HelpSupported=t rue 
IconQualif ier=0 
Iconldentif ier=0 

For Applet2: 
MenuEnt ry= "Applet 2 " 
Offset=0 

Length=menuEntry . length 
HelpSupported=t rue 
IconQualif ier=0 
Iconldentif ier=0 

event= EVENT_MENU_SELECTION_HELP_REQUEST 
1-ToolkitRegistry . isEventSet ( ) is called 
in constructor. 

Perform SIM initialization the facility 

SET UP MENU and without the facilities SET 
EVENT LIST and POLL INTEVAL features 



2-Item identifier ^1 

Menu Selection Help Request envelope is 
sent to the SIM with the item identifier 
of a menu entry of applet 



3-Item identifier =2 

Menu Selection Help Request envelope is 
sent to the SIM with the item identifier 
of a menu entry of applet 



1-The command must return true. 



2- Appletl is triggered and applet2 
is not triggered 



Appletl finalizes 

3- Applet2 Is triggered and appletl 
Is not triggered 
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CRR Number 


Test Case Number 


CRRN1 


1 



6.3.3.4 EVENT_FORMATTED_SMS_PP_ENV 

Test Area Reference: FWK_APT_EFSE. 

6.3.3.4.1 Conformance Requirement 

6.3.3.4.1.1 Normal Execution 

• CRRNl : The applet is triggered by the EVENT_FORMATTED_SMS_PP_ENV once: 

- it has been registered to this event; 

- an envelope APDU carrying an SMS TPDU formatted according to GSM 03.48 [8], is received; 
the toolkit applet to be triggered is registered with the corresponding TAR in the SMS TPDU; 

- the security is verified. 

• CRRN2: The applet is not triggered by the EVENT_FORMATTED_SMS_PP_ENV once it has deregistered 
from this event. 

6.3.3.4.1.2 Parameters error 

No requirements. 

6.3.3.4.1.3 Context Errors 
No requirements. 

6.3.3.4.2 Test Suite Files 



Test Script: 


FWK 


_APT_ 


_EFSE_ 


_l.scr 


Test Applet: 


FWK 


_APT_ 


_EFSE_ 


_l.java 


Load Script: 


FWK 


_APT_ 


_EFSE_ 


_l.ldr 


Cleanup Script: 


FWK 


.APT 


EFSE_ 


.l.ch 


Parameter File: 


FWK 


.APT. 


EFSE_ 


.Ipar 
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6.3.3.4.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applet registration to EVENT 
7TED_SMS_PP_ENV and triggering 

Applet is registered to 
EVENT_FORMATTED_SMS_PP_ENV and 
EVENT_UNRECOGNIZED_ENVELOPE 

1-An Envelope EVENT_FORMATTED_SMS_PP_ENV 
is sent to the SIM. 


1 - Applet is triggered 




2 


Applet dereglstratlon 

ToolkitRegistry . clearEvent ( ) method is 
called for EVENT_FORMATTED_SMS_PP_ENV 

2- A formatted sms pp envelope is sent to 
the SIM. 

An unrecognized envelope is sent to the 
sim 

ToolkitRegistry . setEvent ( ) method is 
called for EVENT_FORMATTED_SMS_PP_ENV 

3- An Envelope FORMATTED_SMS_PP_ENV is sent 
to the SIM 


1 - Applet is not triggered 
2- Applet is triggered 





6.3.3.4.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 (See note) 


1 


CRRN2 


2 


NOTE: The security cliecl<s are not relevant to the test 


designed in this test area; they will be checked in 


subclause 6.3.6. 





6.3.3.5 EVENT_UNFORMATTED_SMS_PP_ENV 

Test Area Reference: FWK_APT_EUSE. 

6.3.3.5.1 Conformance Requirement 

6.3.3.5.1.1 Normal Execution 

• CRRN 1 : The applet is triggered by the EVENT_UNFORM ATTED_SMS_PP_ENV once it has registered to this 
event and an Unformatted Envelope DataDownLoad is received if no proactive session is ongoing. 

• CRRN2: The applet is not triggered by the EVENT_UNFORMATTED_SMS_PP_ENV once it has deregistered 
from this event. 

6.3.3.5.1.2 Parameters error 

No requirements. 

6.3.3.5.1.3 Context Errors 
No requirements. 
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6.3.3.5.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.3.3.5.3 



Test Suite Files 

FWK_APT_EUSE_1 .scr 
FWK_APT_EUSE_1 .Java 
FWK_APT_EUSE_1 .Idr 
FWK_APT_EUSE_1 .clr 
FWK_APT_EUSE_1 .par 

Test Procedure 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



Applet registration to 
EVENT_UNFORMATTED_SMS_PP_ENV and 
triggering 



Applet is registered to the 
EVENT_UNFORMATTED_SMS_PP_ENV and 
ENVENT_FORMATTED_SMS_PP_ENV . 

1- Toolkit Registry . isEventSet ( ) method is 
called for EVENT_UNFORMATTED_SMS_PP_ENV 

2- An Envelope UNFORMATTED_SMS_PP_ENV is 
sent to the SIM. 



1- The method returns true 



2- Applet is triggered 



Applet deregistration 

Toolkit Registry . clearEvent Omethod is 
called for EVENT_UNFORMATTED_SMS_PP_ENV 
1-An unformatted sms pp envelope is sent 
to the SIM. 



A formatted sms pp envelope is sent to the 
sim 

Toolkit Registry . setEvent ( ) method is 
called for EVENT_UNFORMATTED_SMS_PP_ENV 



2-An Envelope UNFORMATTED_SMS_PP_ENV is 
sent to the SIM 



1 - Applet isn't triggered 



2- Applet is triggered 



6.3.3.5.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 



6.3.3.6 EVENT_CALL_CONTROL_BY_SIM 

Test Area Reference: FWK_APT_ECCN. 
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6.3.3.6.1 Conformance Requirement 

6.3.3.6.1.1 Normal Execution 

• CRRN 1 : The applet is triggered by the EVENT_CALL_CONTROL_B Y_SIM once it has registered to this 
event and an Envelope Call Control is received. 

• CRRN2: The applet is not triggered by the EVENT_CALL_CONTROL_BY_SIM once it has deregistered from 
this event. 



6.3.3.6.1.2 

No requirements. 

6.3.3.6.1.3 

No requirements. 

6.3.3.6.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.3.3.6.3 



Parameters error 

Context Errors 

Test Suite Files 

FWK_APT_ECCN_1 .scr 
FWK_APT_ECCN_1 .Java 
FWK_APT_ECCN_1 .Idr 
FWK_APT_ECCN_1 .ck 
FWK_APT_ECCN_1 .par 

Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applets registration to 








EVENT_CALL_CONTROL_BY_SIM and 








triggering 








Appletl is registered to 








EVENT_CALL_CONTROL_BY_S IM . 








Applet2 is registered to 








EVENT_FORMATTED_SMS_PP_ENV 








1-An Envelope Call control by SIM is sent 








to SIM 


1- Appletl is triggered 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 




Applet deregistration and registration of the 








third aDDlet to EVENT CALL- 








CONTROL_BY_SIIVI. 








l-An Envelope Formatted SMS PP envelope is 


1 -Applet2 is triggered by 






sent to SIM 


EVENT_F0RMATTED_SI\/1S_PP_ 








ENV. 






Applet2 constructs a DISPLAY TEXT 








proactive command. 








2-ProactiveHandler . send ( ) method is called 




2- A proactive command 








DISPLAY TEXT is sent and 








applet is suspended until 








the terminal response 




3-An Envelope Call control by SIM envelope 


3- Appletl is triggered 






is sent to SIM 








ToolkitRegistry . clearEvent ( ) is called for 








EVENT_CALL_CONTROL_BY_S IM . 












TERMINAL RESPONSE of 






Appletl finalizes. 


DISPLAY TEXT is sent to 






the SIM 




ToolkitRegistry . setEvent ( ) method is 








called for EVENT CALL CONTROL BY SIM. 










Applet2 finalizes 




3 


Applet triggering 








An Envelope Call control by SIM envelope 


Applet2 is triggered. 






is sent to SIM 


(Appletl is not triggered) 





6.3.3.6.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1, 2, 3 


CRRN2 


3 



6.3.3.7 EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM 

Test Area Reference: FWK_APT_EMCN. 

6.3.3.7.1 Conformance Requirement 

6.3.3.7.1.1 Normal Execution 

• CRRNl : The applet is triggered by the EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM once it has 

registered to this event and an Envelope MO Short Message Control. 

• CRRN2: The applet is not triggered by the EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM once it 
has deregistered from this event. 

6.3.3.7.1.2 Parameters error 

No requirements. 



ETS/ 



3GPP TS 11.13 version 8.2.1 Release 1999 

6.3.3.7.1.3 Context Errors 

No requirements. 

6.3.3.7.2 

Test Script: 
Test Applet: 
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Load Script: 
Cleanup Script: 
Parameter File: 

6.3.3.7.3 



Test Suite Files 

FWK_APT_EMCN_1 .scr 
FWK_APT_EMCN_1 .java 
FWK_APT_EMCN_2.java 
FWK_APT_EMCN_1 .Idr 
FWK_APT_EMCN_1 .clr 
FWK_APT_EMCN_1 .par 

Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applet registration to 








EVENT_MO_SHORT_MESSAGE_CONTROL_B 








Y_SIWI and triggering 








Appletl is registered to 








EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM. 








Applet2 is registered to 








EVENT_FORMATTED_SMS_PP_ENV . 








1-An Envelope MO short message envelope is 


1- Appletl is triggered. 






sent to SIM 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


2 


Applet deregistration and registration of the 








third applet to 








EVENT MO SHORT MESSAGE CONTROL B 








Y_SIM. 








The STF shall not reply busy to a call control 








envelope 








l-An Envelope formatted SMS PP envelope is 


1- Applet2 is triggered. 






senTi Tio oil*!. 






Applet2 builds a DISPLAY TEXT proactive 








command. 












2- A Proactive command 




2-ProactiveHandler . send ( ) method is 




niQPI AV TPYT ic cont and 
Ulor LM 1 1 CA 1 lb bc^llL dllU 




called. 




applet is suspended until 








the terminal response 




3-An Envelope MO Short message envelope is 


3- Appletl is triggered. 






sent to SIM 








ToolkitRegistry . clearEvent ( ) for 








EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM. 












TERMINAL RESPONSE of 






Appletl finalizes. 


DISPLAY TEXT is sent to 








the SIM 




ToolkitRegistry . setEvent ( ) method is 








called for 








EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM. 










Applet2 finalizes. 




3 


Applets triggering 

An Envelope MO SMS control by SIM envelope 
is sent to SIM 


Applet2 is triggered. 
(Appletl is not triggered) 





6.3.3.7.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1, 2, 3 


CRRN2 


3 



6.3.3.8 EVENT_TIMER_EXPIRATION 

Test Area Reference: FWK_APT_ETEX. 

6.3.3.8.1 Conformance Requirement 

6.3.3.8.1.1 Normal Execution 

• CRRN 1 : The applet is triggered by the EVENT_TIMER_EXPIRATION once it has been registered to this event 
and an Envelope Timer Expiration with a Timer Identifier of the applet is received if no proactive session is 
ongoing. 

• CRRN2: The applet is not triggered by the EVENT_TIMER_EXPIRATION once it has been deregistered from 
this event. 
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6.3.3.8.1.2 Parameters error 

No requirements. 

6.3.3.8.1.3 

No requirements. 

6.3.3.8.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 
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6.3.3.8.3 



Context Errors 

Test Suite Files 

FWK_APT_ETEX_1 .scr 
FWK_APT_ETEX_1 .j ava 
FWK_APT_ETEX_1 .Idr 
FWK_APT_ETEX_1 .clr 
FWK_APT_ETEX_1 .par 

Test Procedure 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



Applet registration to 
EVENT_TIMER_EXPIRATION and 
triggering 

Applet is registered to the 
EVENT_TIMER_EXPIRATION using the 
allocateTimer ( ) method and to 
EVENT_FORMATTED_SMS_PP_ENV . 

event= EVENT_TIMER_EXPIRATION 

1- Toolkit Registry . isEventSet ( ) 
method is called. 

2- An Envelope TIMER_EXPIRATION is 
sent to the SIM. 



1 - The method returns true 
2- Applet is triggered. 



Applet dereglstratlon 

Timer id=l 

Toolkit Registry . ReleaseTimer ( ) method 
is called 

1-An Envelope timer expiration is 
sent to the SIM. 



An Envelope formatted sms pp 
envelope is sent to the sim 

Toolkit Registry .AllocateTimer ( ) 
method is called 

2-An Envelope TIMER_EXPIRATION is 
sent to the SIM. 



1 - Applet isn't triggered 



2- Applet is triggered 



6.3.3.8.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 
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6.3.3.9 EVENT_UNFORMATTED_SMS_CB 

Test Area Reference: FWK APT EUCB. 



6.3.3.9.1 



6.3.3.9.1.1 



Conformance Requirement 
Normal Execution 



• CRRNl : The applet is triggered by the EVENT_UNFORMATTED_SMS_CB once it has registered to this event 
and an Envelope Cell Broadcast DownLoad is received. 

• CRRN2: The applet is not triggered by the EVENT_UNFORMATTED_SMS_CB once it has deregistered from 
this event. 



6.3.3.9.1.2 

No requirements. 

6.3.3.9.1.3 

No requirements. 

6.3.3.9.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.3.3.9.3 



Parameters error 

Context Errors 

Test Suite Files 

FWK_APT_EUCB_l.scr 
FWK_APT_EUCB_1 .java 
FWK_APT_EUCB_1 .Idr 
FWK_APT_EUCB_1 .ch 
FWK_APT_EUCB_1 .par 

Test Procedure 



Id 



Description 



API Expectation 



APDU Expectation 



Applet registration to 
EVENT_UNFORIVIATTED_SMS_CB and 
triggering 



Applet is registered to the 
EVENT_UNFORMATTED_SMS_CB and 
EVENT_FORMATTED_SMS_PP_ENV . 

event= EVENT_UNFORMATTED_SMS_CB 

1- Toolkit Registry. isEventSet method is 
called. 

2 - An Envelope UNFORMATTED_SMS_CB is sent 
to the SIM. 



1 - Method returns true. 
2- Applet is triggered 
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Id 



Description 



API Expectation 



APDU Expectation 



Applet deregistration 



Toolkit Registry . ClearEvent () method is 
called for EVENT_UNFORMATTED_SMS_CB 



1-An Envelope UNFORMATTED_SMS_CB is sent 
to the SIM. 



An Envelope formatted sms pp envelope is 

sent to the sim 

event= EVENT_UNFORMATTED_SMS_CB 

Toolkit Registry. setEvent method is called 
for EVENT UNFORMATTED SMS CB 



2-An Envelope UNFORMATTED_SMS_CB is sent 
to the SIM. 



1 - Applet isn't triggered 



2- Applet is triggered 



6.3.3.9.4 



Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 



6.3.3.10 EVENT_EVENT_DOWNLOAD_MT_CALL 

Test Area Reference: FWK APT EDMC. 



6.3.3.10.1 
6.3.3.10.1.1 



Conformance Requirement 
Normal Execution 



• CRRNl : The applet is triggered by the EVENT_EVENT_DOWNLOAD_MT_CALL once it has registered to 
this event and an Envelope Event DownLoad MT Call is received. 

• CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_MT_CALL once it has 
deregistered from this event. 



6.3.3.10.1.2 

No requirements. 

6.3.3.10.1.3 

No requirements. 

6.3.3.10.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 



Parameters error 
Context Errors 
Test Suite Files 

FWK_APT_EMSE_1 .scr 
FWK_APT_EMSE_1 .Java 
FWK_APT_EMSE_1 .Idr 
FWK APT EMSE l.ch 
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Parameter File: FWK_APT_EMSE_1 .par 



6.3.3.10.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applet registration to 
EVENT_EVENT_DOWNLOAD_MT_CALL and 
triggering 

Applet is registered to the 
EVENT_EVENT_DOWNLOAD_MT_CALL and to 
EVENT_FORMATTED_SMS_PP_ENV . 

event= EVENT_EVENT_DOWNLOAD_MT_CALL 

1- Toolkit Registry . isEventSet ( ) method is 
called. 

2- An Envelope EVENT_DOWNLOAD_MT_CALL is 
sent to the SIM. 


1 - The method returns true 
2- Applet is triggered 




2 


Applet deregistration 

event= EVENT_EVENT_DOWNLOAD_MT_CALL 
Toolkit Registry . clearEvent method is 
called 

Perform SIM initialization with all the 

facilities supported 

1- An Envelope EVENT_DOWNLOAD_MT_CALL is 
sent to the SIM. 

An Envelope formatted sms pp envelope is 
sent to the sim 

event= EVENT_EVENT_DOWNLOAD_MT_CALL 
Toolkit Registry . setEvent ( ) method is 
called 

Perform SIM initialization with all the 
facilities supported 

2- An Envelope EVENT_DOWNLOAD_MT_CALL is 
sent to the SIM. 


1 - Applet isn't triggered 
2- Applet is triggered 





6.3.3.10.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 



6.3.3.1 1 EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 

Test Area Reference: FWK_APT_EDCC. 
6.3.3.11.1 Conformance Requirement 

6.3.3.1 1.1.1 Normal Execution 

• CRRN 1 : The applet is triggered by the EVENT_EVENT_DO WNLO AD_C ALL_CONNECTED once it has 
registered to this event and an Envelope Event DownLoad Call Connected is received. 
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• CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_CALL_CONNECTED once it has 
deregistered from this event. 



6.3.3.11.1.2 

No requirements. 



Parameters error 



6.3.3.11.1.3 
No requirements. 

6.3.3.11.2 

Test Script: 
Test Applet: 
Load Script: 
Clean-up Script: 
Parameter File: 



Context Errors 

Test Suite Files 

FWK_APT_EDCC_1 .scr 
FWK_APT_EDCC_1 .Java 
FWK_APT_EDCC_1 .Idr 
FWK_APT_EDCC_1 .ch 
FWK_APT_EDCC _l.par 



6.3.3.11.3 



Test Procedure 



Id 



Description 



API/Frameworl< Expectation 



APDU Expectation 



Applet registration to 
EVENT_EVENT_DOWNLOAD_CALL_CONNECT 
ED and triggering 

Applet is registered to the 

EVENT_EVENT_DOWNLOAD_CALL_CONNECTED and to 
EVENT_FORMATTED_SMS_PP_ENV . 

event= EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 

1- Toolkit Registry . isEventSet ( ) method is 
called. 

2- An Envelope 

EVENT_DOWNLOAD_CALL_CONNECTED is sent to 
the SIM. 



1- Method returns true 



2- Applet is triggered. 



Applet deregistration 



event=EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 
Toolkit Registry . clearEvent method is 
called 

Perform SIM initialization with all the 

facilities supported 

1-A call connected event download is sent 
to the SIM. 



An Envelope formatted sms pp envelope is 
sent to the sim 

Event= EVENT_EVENT_DOWNLOAD_CALL_CONNECTED 
Toolkit Registry . setEvent ( ) method is 
called 

Perform SIM initialization with all the 
facilities supported 

2-An Envelope 

EVENT_DOWNLOAD_CALL_CONNECTED is sent to 
the SIM. 



1 - Applet isn't triggered 



2- Applet is triggered 
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CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 



6.3.3.12 EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED 

Test Area Reference: FWK APT EDCD. 



6.3.3.12.1 

6.3.3.12.1.1 



Conformance Requirement 

Normal Execution 



• CRRN 1 : The applet is triggered by the EVENT_EVENT_DOWNLO AD_C ALL_DISCONNECTED once it has 
registered to this event and an Envelope Event DownLoad Call Disconnected is received. 

• CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED once it 
has deregistered from this event. 



6.3.3.12.1.2 
No requirements. 

6.3.3.12.1.3 

No requirements. 

6.3.3.12.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.3.3.12.3 



Parameters error 
Context Errors 

Test Suite Files 

FWK_APT_EDCD_l.scr 
FWK_APT_EDCD_1 .Java 
FWK_APT_EDCD_1 .Idr 
FWK_APT_EDCD_1 .clr 
FWK_APT_EDCD_1 .par 

Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applet registration to 
EVENT_EVENT_DOWNLOAD_CALL_DISCONN 
ECTED and triggering 

Applet is registered to the 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED and 
to EVENT_FORMATTED_SMS_PP_ENV. 








Event=EVENT_EVENT_DOWNLOAD_CALL_DISCONNECT 
ED 

1-Toolkit Registry . isEventSet ( ) method is 
called. 








1- Method returns true 






2-An Envelope 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED is 
sent to the SIM. 


2- Applet is triggered. 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


2 


Applet deregistration 

Event= 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED 
Toolkit Registry . clearEvent method is 
called 

Perform SIM initialization with all the 
facilities supported 

1- An Envelope 

EVENT_DOWNLOAD_CALL_DISCONNECTED is sent 
to the SIM. 

a formatted sms pp envelope is sent to the 
sim. 

Event= 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED 
Toolkit Registry . setEvent ( ) method is 

called 

Perform SIM initialization with all the 
facilities supported 

2- An Envelope 

EVENT_EVENT_DOWNLOAD_CALL_DISCONNECTED is 
sent to the SIM. 


1 - Applet isn't triggered 
2- Applet is triggered 





6.3.3.12.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 



6.3.3.13 EVENT_EVENT_DOWNLOAD_LOCATION_STATUS 

Test Area Reference: FWK APT EDLS. 



6.3.3.13.1 



6.3.3.13.1.1 



Conformance Requirement 
Normal Execution 



• CRRN 1 : The applet is triggered by the EVENT_EVENT_DOWNLO AD_LOCATION_STATUS once it has 
registered to this event and an Envelope Event DownLoad Location Status is received. 

• CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_LOCATION_STATUS once it has 
deregistered from this event. 



6.3.3.12.1.2 

No requirements. 

6.3.3.12.1.3 
No requirements. 

6.3.3.13.2 

Test Script: 
Test Applet: 
Load Script: 



Parameters error 
Context Errors 

Test Suite Files 

FWK_APT_EDLS_1 .scr 
FWK_APT_EDLS_1 .Java 
FWK APT EDLS l.ldr 



ETSI 



3GPP TS 11 .1 3 version 8.2.1 Release 1 999 344 ETSI TS 1 01 955 V8.2.1 (2003-04) 

Cleanup Script: FWK_APT_EDLS_l.clr 
Parameter File: FWK_APT_EDLS_1 .par 



6.3.3.13.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applet registration to 
EVENT_EVENT_DOWNLOAD_LOACTION_STA 
TUS and triggering 

Applet is registered to the 

EVENT_EVENT_DOWNLOAD_LOCAT I ON_S TATUS and 
to EVENT_FORMATTED_SMS_PP_ENV. 

Event =EVENT_EVENT_DOWNLOAD_LOCAT I ON_S TATUS 

1- Toolkit Registry . isEventSet ( ) method is 
called. 

2- An Envelope 

EVENT_EVENT_DOWNLOAD_LOCAT ION_S TATUS i S 
sent to the SIM. 


1- Method returns true 

2- Applet is triggered. 




2 


Applet dereglstratlon 

Event =EVENT_EVENT_DOWNLOAD_LOCAT I ON_S TATUS 
Toolkit Registry . clearEvent () method is 
called 

Perform SIM initialization with all the 
facilities supported 

1- An Envelope 

EVENT_DOWNLOAD_LOCATION_STATUS is sent to 
the SIM. 

a formatted sms pp envelope is sent to the 
sim 

Event= 

EVENT_EVENT_DOWNLOAD_LOCAT ION_S TATUS 
Toolkit Registry . setEvent ( ) method is 

called 

Perform SIM initialization with all the 
facilities supported 

2- An Envelope 

EVENT_DOWNLOAD_LOCATION_STATUS is sent to 
the SIM. 


1 - Applet Isn't triggered 
2- Applet Is triggered 





6.3.3.13.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 



6.3.3.14 EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

Test Area Reference: FWK_APT_EDUA. 
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6.3.3.14.1 



6.3.3.14.1.1 



Conformance Requirement 
Normal Execution 



• CRRN 1 : The applet is triggered by the EVENT_EVENT_DOWNLOAD_USER_ACTI VIT Y once it has 
registered to this event and an Envelope Event DownLoad User Activity is received. 

• CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_USER_ACTIVITY once it has 
deregistered from this event. 



6.3.3.14.1.2 
No requirements. 

6.3.3.14.1.3 

No requirements. 

6.3.3.14.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 



Parameters error 

Context Errors 

Test Suite Files 

FWK_APT_EDUA_1 .scr 
FWK_APT_EDUA_1 .Java 
FWK_APT_EDUA_1 .Idr 
FWK_APT_EDUA_1 .clr 
FWK_APT_EDUA_1 .par 
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6.3.3.14.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applet registration to 
EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 
and triggering 

Applet is registered to the 

EVENT_EVENT_DOWNLOAD_USER_ACTIVITY and to 
EVENT_FORMATTED_SMS_PP_ENV . 

Event= EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 

1- Toolkit Registry . isEventSet ( ) method is 
called. 

2- An Envelope EVENT_DOWNLOAD_USER_ACTIVITY 
is sent to the SIM. 


1- Method returns true 

2- Applet is triggered 




2 


Applet deregistration 

Event= EVENT„EVENT_DOWNLOAD_USER__ACTIVITY 
Toolkit Registry . clearEvent method is 
called 

Perform SIM initialization with all the 
facilities supported 

1- An Envelope EVENT_DOWNLOAD_USER_ACTIVITY 
is sent to the SIM. 

a formatted sms pp envelope is sent to the 

sim 

Event= EVENT_EVENT_DOWNLOAD_USER_ACTIVITY 
Toolkit Registry . setEvent ( ) method is 

called 

Perform SIM initialization with all the 
facilities supported 

2- An Envelope EVENT_DOWNLOAD_USER_ACTIVITY 
is sent to the SIM. 


1 - Applet isn't triggered 
2- Applet is triggered 





6.3.3.14.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 



6.3.3.15 EVENT_EVENT_DOWNLOADJDLE_SCREEN_AVAILABLE 

Test Area Reference: FWK_APT_EDIS. 

6.3.3.15.1 Conformance Requirement 

6.3.3.15.1.1 Normal Execution 

• CRRNl : The applet is triggered by the EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE once 
it has registered to this event and an Envelope Event DownLoad Idle Screen Available is received. 

• CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 
once it has deregistered from this event. 
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6.3.3.15.1.2 

No requirements. 

6.3.3.15.1.3 
No requirements. 

6.3.3.15.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 



Parameters error 

Context Errors 

Test Suite Files 

FWK_APT_EDIS_1 .scr 
FWK_APT_ED1S_1 .Java 
FWK_APT_ED1S_1 .Idr 
FWK_APT_ED1S_1 .clr 
FWK_APT_EDIS_l.par 
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6.3.3.15.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applet registration to 
EVENT_EVENT_DOWNLOADJDLE_SCREEN_ 
AVAILABLE and triggering 

Applet is registered to the 

EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 

and to EVENT_FORMATTED_SMS_PP_ENV 

Event= 

EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 

1- Toolkit Registry . isEventSet ( ) method is 
called. 

2- An Envelope 

EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE is 
sent to the SIM. 


1- Method returns true 

2- Applet is triggered 




2 


Applet deregistration 

Event =EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVA 
ILABLE 

Toolkit Registry . clearEvent method is 
called 

Perform SIM initialization with all the 
facilities supported 

1- An Envelope 

EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE is 
sent to the SIM. 

a formatted sms pp envelope is sent to the 

sim 

Event= 

EVENT_EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE 

Toolkit Registry . setEvent ( ) method is 

called 

Perform SIM initialization with all the 
facilities supported 

2- An Envelope 

EVENT_DOWNLOAD_IDLE_SCREEN_AVAILABLE is 
sent to the SIM. 


1 - Applet isn't triggered 
2- Applet is triggered 





6.3.3.15.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 



6.3.3.16 EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 

Test Area Reference: FWK_APT_EDCR. 
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6.3.3.16.1 



6.3.3.16.1.1 



Conformance Requirement 
Normal Execution 



• CRRN 1 : The applet is triggered by the EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS once it 
has registered to this event and Envelope Event DownLoad Card Reader Status is received. 

• CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS once 
it has deregistered from this event. 



6.3.3.16.1.2 
No requirements. 

6.3.3.16.1.3 

No requirements. 

6.3.3.16.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 



Parameters error 

Context Errors 

Test Suite Files 

FWK_APT_EDCR_1 .scr 
FWK_APT_EDCR_1 .Java 
FWK_APT_EDCR_1 .Idr 
FWK_APT_EDCR_1 .ck 
FWK_APT_EDCR_1 .par 
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6.3.3.16.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applet registration to 
EVENT_EVENT_DOWNLOAD_CARD_READER 
_STATUS and triggering 

Applet is registered to the 
EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 
and to EVENT_FORMATTED_SMS_PP_ENV 

Event =EVENT_EVENT_DOWNLOAD_CARD_READER_STA 
TUS 

1- Toolkit Registry . isEventSet ( ) method is 
called. 

2- An Envelope 

EVENT_DOWNLOAD_CARD_READER_STATUS is sent 
to the SIM. 


1- Method returns true 

2- Applet is triggered 




2 


Applet deregistration 

Event= 

EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 

Toolkit Registry . clearEvent method is 
called 

Perform SIM initialization with all the 
facilities supported 

1- An Envelope 

EVENT_DOWNLOAD_CARD_READER_STATUS is sent 
to the SIM. 

An Envelope formatted sms pp envelope is 
sent to the sim 

Event= 

EVENT_EVENT_DOWNLOAD_CARD_READER_STATUS 

Toolkit Registry . setEvent ( ) method is 
called 

Perform SIM initialization with all the 
facilities supported 

2- An Envelope 

EVENT_DOWNLOAD_CARD_READER_STATUS is sent 
to the SIM. 


1 - Applet isn't triggered 
2- Applet is triggered 





6.3.3.16.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 



6.3.3.17 EVENT_UNRECOGNIZED_ENVELOPE 

Test Area Reference: FWK_APT_EUEV. 
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6.3.3.17.1 Conformance Requirement 

6.3.3.17.1.1 Normal Execution 

• CRRN 1 : The applet is triggered by the EVENT_UNRECOGNIZED_EN VELOPE once it has registered to this 
event and an Unrecognized Envelope is received. 

• CRRN2: The applet is not triggered by the EVENT_UNRECOGNIZED_ENVELOPE once it has deregistered 
from this event. 

6.3.3.1 7.1 .2 Parameters error 
No requirements. 

6.3.3.17.1.3 Context Errors 

No requirements. 

6.3.3.17.2 Test Suite Files 



Test Script: 


FWK 


.APT 


.EUEN. 


.l.scr 


Test Applet: 


FWK 


.APT. 


.EUEN_ 


.l.java 


Load Script: 


FWK 


.APT. 


.EUEN. 


.l.ldr 


Cleanup Script: 


FWK 


.APT 


_EUEN_ 


.l.ch- 


Parameter File: 


FWK 


_APT 


_EUEN_ 


-l.par 
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6.3.3.17.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applet registration to 
EVENT_UNRECOGNIZED_ENVELOPE and 
triggering 

Applet is registered to the 
EVENT_UNRECOGNIZED_ENVELOPE and to 
EVENT_FORMMATTED_SMS_PP_ENV 

Event= EVENT_UNRECOGNIZED_ENVELOPE 

1- Toolkit Registry . isEventSet ( ) method is 
called. 

2- An Envelope UNRECOGNIZED_ENVELOPE is 

sent tC' the SIM. 


1- Method returns true 

2- Applet is triggered 




2 


Applet deregistration 

Event= EVENT_UNRECOGNIZED_ENVELOPE 
Toolkit Registry . clearEvent method is 
called 

1- An Envelope UNRECOGNIZED_ENVELOPE is 
sent to the SIM. 

a formatted sms pp envelope is sent to the 
sim 

Event= EVENT_UNRECOGNI ZED_ENVELOPE 
Toolkit Registry . setEvent ( ) method is 
called 

2- An Envelope UNRECOGNIZED_ENVELOPE is 
sent to the SIM. 


1 - Applet isn't triggered 
2- Applet is triggered 





6.3.3.17.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 



6.3.3.18 EVENT_STATUS_COMMAND 

Test Area Reference: FWK_APT_ESTC. 

6.3.3.18.1 Conformance Requirement 

6.3.3.18.1.1 Normal Execution 

• CRRNl : The applet is triggered by the EVENT_STATUS_COMMAND once it has registered to this event and 

a Status Command is received. 

• CRRN2: The applet is not triggered by the EVENT_STATUS_COMMAND once it has deregistered from this 
event. 

6.3.3.18.1.2 Parameters error 

No requirements. 
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6.3.3.18.1.3 

No requirements. 

6.3.3.18.2 

Test Script: 
Test Applet: 



Load Script: 
Cleanup Script: 
Parameter File: 

6.3.3.18.3 



Context Errors 

Test Suite Files 

FWK_APT_ESTC_1 .scr 
FWK_APT_ESTC_1 .java 
FWK_APT_ESTC_2.java 
FWK_APT_ESTC_3.java 
FWK_APT_ESTC_1 .Idr 
FWK_APT_ESTC_1 .clr 
FWK_APT_ESTC_1 .par 

Test Procedure 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



Applets registration to 
EVENT_STATUS_COIUIMAND and triggering 

Appletl is registered to 
EVENT_STATUS_COMMAND using the 
requestPollInterval ( ) command. 

Applet2 is registered to 
EVENT_STATUS_COMMAND using the 
RequestPollInterval ( ) command. 

Applets is registered to 
EVENT_FORMATTED_SMS_PP_ENV . 

1-A status command is sent to SIM 



1- Appletl is triggered. 
Appletl finalizes 

2- Applet2 is triggered. 
Applet2 finalizes 

3- Applet 3 is not triggered 



Applet deregistration and registration of the 
third applet to EVENT_STATUS_COMMAND. 
The STF shall not reply busy to a call control 
envelope 

l-A formatted sms pp envelope is sent to 
SIM 



Applets builds a DISPLAY TEXT. 

2- ProactiveHandler . send ( ) is called 

3- A status command is sent to SIM. 



requestPollInteval with POLL_NO_DURATION 
is called 



1 - Applets is triggered. 



2- A proactive command 
DISPLAY TEXT is sent and 
applet is suspended until 
the terminal response 



3- Appletl is triggered. 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 




requestPollInteval with POLL_NO_DURATION 
is called 

requestPollInterval ( ) method is called. 


Appletl finalizes 

4- Applet2 is triggered. 

Applet2 finalizes 
Applet3 finalizes 


5- TERMINAL RESPONSE 
of DISPLAY TEXT Is sent to 
the SIM 


3 


Applets triggering 

Perform SIM initialization with all the 
facilities supported 

Status command is sent to SIM. 


Applets is triggered. 
(Appletl and Applet2 are not 
triggered) 





6.3.3.18.4 Test Coverage 



CR Number 


Test Case Number 


CRRN1 


1, 2, 3 


CRRN2 


3 



6.3.3.19 EVENT_FORMATTED_SMS_CB 

Test Area Reference: FWK_APT_EFCB. 

6.3.3.19.1 Conformance Requirement 

6.3.3.19.1.1 Normal Execution 

• CRRN 1 : The applet is triggered by the E VENT_FORMATTED_SMS_CB once: 

- it has been registered to this event; 

- an envelope APDU carrying a Cell Broadcast Page, formatted according to GSM 03.48 [8], is received; 

- the toolkit applet to be triggered is registered with the corresponding TAR in the CB page; 

- the security is verified. 

• CRRN2: The applet is not triggered by the EVENT_FORMATTED_SMS_CB once it has deregistered from this 
event. 

6.3.3.19.1.2 Parameters error 
No requirements. 

6.3.3.19.1.3 Context Errors 

No requirements. 

6.3.3.19.2 Test Suite Files 

Test Script: FWK_APT_EFCB_l.scr 
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Test Applet: FWK_APT_EFCB_1 Java 

Load Script: FWK_APT_EFCB_l.ldr 

Cleanup Script: FWK_APT_EFCB_l.clr 

Parameter File: FWK_APT_EFCB_1 .par 



6.3.3.19.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applet registration to 
EVENT_FORMATTED_SMS_CB and triggering 

Applet is registered to 
EVENT_FORMATTED_SMS_CB and 
EVENT_FORMATTED_SMS_PP_ENV 

1-An Envelope EVENT_FORMATTED_SMS_CB is 

Qf:int tn the ^TM 


1 -Applet is triggered 




2 


Applet dereglstratlon 

ToolkitRegistry . clearEvent ( ) method is 
called for EVENT_FORMATTED_SMS_CB 

1- A formatted SMS CB envelope is sent to 
the SIM. 

2- An envelope SMS-PP formatted is sent to 
the SIM 

ToolkitRegistry . setEvent ( ) method is 
called for EVENT_FORMATTED_SMS_CB 

3- An Envelope FORMATTED_SMS_CB is sent to 
the SIM 


1 - Applet is not triggered 

2- Applet is triggered 

3- Applet is triggered 





6.3.3.19.4 Test Coverage 



CR Number 


Test Case Number 


CRRN1 (See note) 


1,2 


CRRN2 


2 


NOTE: The security checks are not relevant to the test 


designed in this test area; they will be checked in 


subclause 6.3.6. 





6.3.3.20 EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION 

Test Area Reference: FWK_APT_EDLG. 
6.3.3.20.1 Conformance Requirement 

6.3.3.20.1.1 Normal Execution 

• CRRN 1 : The applet is triggered by the EVENT_EVENT_DO WNLO AD_LANGU AGE_SELECTION once it 
has registered to this event and an Envelope Event DownLoad Language Selection is received. 

• CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION once 
it has deregistered from this event. 
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6.3.3.20.1.2 

No requirements. 

6.3.20.1.3 

No requirements. 

6.3.3.20.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.3.3.20.3 



Parameters error 

Context Errors 

Test Suite Files 

FWK_APT_EDLG_1 .scr 
FWK_APT_EDLG_1 .Java 
FWK_APT_EDLG_1 .Idr 
FWK_APT_EDLG_1 .clr 
FWK_APT_EDLG_1 .par 

Test Procedure 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



Applet registration to 
EVENT_EVENT_DOWNLOAD_LANGUAGE_SE 
LECTION and triggering 

Applet is registered to the 
EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION 
and to EVENT_FORMATTED_SMS_PP_ENV. 

Event= 

EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION 



1- Toolkit Registry . isEventSet ( ) method is 
called. 

2- An Envelope 

EVENT_DOWNLOAD_LANGUAGE_SELECTION is sent 
to the SIM. 



1 -Method returns true 



2- Applet is triggered 



ETSI 



3GPP TS 11.13 version 8.2.1 Release 1999 



357 



ETSI TS 101 955 V8.2.1 (2003-04) 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



Applet deregistration 



Event= 

EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION 
Toolkit Registry . clearEvent method is 
called 

Perform SIM initialization with Profile 
Download, SMS PP Data Download, Command 
Result and Language Selection facilities. 

1-An Envelope 

EVENT_DOWNLOAD_LANGUAGE_SELECTION is sent 
to the SIM. 



1 - Applet isn't triggered 



a formatted sms pp envelope is sent to the 
sim 



Event= 

EVENT_EVENT_DOWNLOAD_LANGUAGE_SELECTION 
Toolkit Registry . setEvent ( ) method is 

called 



Perform SIM initialization with Profile 
Download, SMS PP Data Download, Command 
Result and Language Selection facilities . 

2-An Envelope 

EVENT_DOWNLOAD_LANGUAGE_SELECTION is sent 
to the SIM. 



2- Applet is triggered 



6.3.3.20.4 Test Coverage 



CR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 



6.3.3.21 EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION 

Test Area Reference: FWK APT EDBT. 



6.3.3.21.1 



6.3.3.21.1.1 



Conformance Requirement 
Normal Execution 



• CRRN 1 : The applet is triggered by the EVENT_EVENT_DOWNLO AD_BROWSER_TERMIN ATION once it 
has registered to this event and an Envelope Event DownLoad Browser Termination is received. 

• CRRN2: The applet is not triggered by the EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION 

once it has deregistered from this event. 



6.3.3.21.1.2 

No requirements. 

6.3.3.21.1.3 

No requirements. 

6.3.3.21.2 

Test Script: 



Parameters error 

Context Errors 

Test Suite Files 

FWK APT EDBT l.scr 
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Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 



FWK_APT_EDBT_1 Java 
FWK_APT_EDBT_1 .Idr 
FWK_APT_EDBT_1 .clr 
FWK_APT_EDBT_1 .par 



.3.3.21.3 



Test Procedure 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



Applet registration to 
EVENT_EVENT_DOWNLOAD_ 
BROWSER_TERMINATION and triggering 



Applet is registered to the 
EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION 
and to EVENT_FORMATTED_SMS_PP_ENV 

Event= 

EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION 

1- Toolkit Registry. isEventSet method is 
called. 

2- An Envelope 

EVENT_DOWNLOAD_BROWSER_TERMINATION is sent 
to the SIM. 



1 - Method returns true 

2- Applet is triggered 



Applet dereglstratlon 



Event= 

EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION 
Toolkit Registry . clearEvent () method is 
called 

Perform SIM initialization with Profile 
Download, SMS PP Data Download, Command 
Result and Browser Termination facilities. 

1-An Envelope 

EVENT_DOWNLOAD_BROWSER_TERMINATION is sent 
to the SIM. 



a formatted sms pp envelope is sent to the 
sim 

Event= 

EVENT_EVENT_DOWNLOAD_BROWSER_TERMINATION 
Toolkit Registry . setEvent ( ) method is 
called 

Perform SIM initialization with Profile 
Download, SMS PP Data Download, Command 
Result and Browser Termination facilities. 

2-An Envelope 

EVENT_DOWNLOAD_BROWSER_TERMINATION is sent 
to the SIM. 



1 - Applet isn't triggered 



2- Applet is triggered 



6.3.3.21 .4 Test Coverage 



CR Number 


Test Case Number 


CRRN1 


1,2 


CRRN2 


2 
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6.3.4 Proactive Command Sending by the STF 
6.3.4.1 System Proactive Commands 

Test Area Reference: FWK_PCS_SPCO. 

6.3.4.1.1 Conformance Requirements 

6.3.4.1.1.1 Normal Execution 

• CRRNl : When a toolkit applet changes a menu entry of its registry object, the SIM Toolkit Framework shall 
dynamically (see note) update the menu stored in the ME during the current card session. 

• CRRN2: The STF shall use the data of the EFsume file when issuing the SET UP MENU proactive command. 

• CRRN3: For all EVENT_EVENT_DOWNLOAD_ (see note): When a toolkit applet changes one or more of 
these requested events of its registry object, the STF shall dynamically (see note) update the event list stored in 
the ME during the current card session by SET UP EVENT LIST proactive connmand. 

NOTE: The STF shall send its system proactive command as soon as no proactive session is pending and all the 
applets registered to the current events have been triggered and have returned from the processToolkit 
method invocation. 

6.3.4.1 .1 .2 Parameters error 

No requirements. 

6.3.4.1 .1 .3 Context Errors 
No requirements. 

6.3.4.1.2 Test Suite Files 



Test Script: 


FWK 


_PCS_ 


_SPCO_ 


_l.scr 


Test Applet: 


FWK 


_PCS_ 


_SPCO_ 


_l.java 


Load Script: 


FWK 


PCS. 


.SPCO. 


.l.ldr 


Cleanup Script: 


FWK 


PCS. 


.SPCO. 


.l.clr 


Parameter File: 


FWK 


PCS. 


.SPCO. 


.l.par 



6.3.4.1.3 Test Procedure 



Id 


Description 


API/Frameworl< Expectation 


APDU Expectation 


1 


Install Applet 1, Registered to the 
EVENT EVENT DOWNLOAD MT CALL and 
EVENT EVENT DOWNLOAD 
LOCATION_STATUS 

Perform SIM initialization with EVENT 
DOWNLOAD facilities supported 




setEventLlst proactive 
command 

[Event list]= '19020003' 
or '99020003' 


2 


Trigger the applet by ENVELOPE 
(SMS_FORMATTED_PP) command 

clear the events and build a display text 
command 




1 . DISPLAY TEXT Proactive 
command 

2. SET UP EVENT LIST 
Proactive command 
[CommandQualifier]= OOh 
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CRR number 


Test case number 


N1 


see: 

subclause 6.2.9.2, CRRN1, 
subclause 6.2.9.4, CRRN3, 
subclause 6.2.9.5 CRRN4, 
subclause 6.2.9.8 CRRN1 


N2 


see: 

subclause 6.2.9.2 CRRN1, 
subclause 6.2.9.8 CRRN1 


N3 


1,2 



6.3.4.2 Interaction with GSIVI commands 

Test Area Reference: FWK_PCS_IGCO. 

6.3.4.2.1 Conformance Requirements 

6.3.4.2.1.1 Normal Execution 

• CRRNl: The STF shall process a GSM command even when a proactive command is pending (before and after 
the FETCH command until the terminal response). The STF shall answer with the SWl and SW2 described in 
GSM 11.11 [3] and GSM 11.14 [4]. 

6.3.4.2.1 .2 Parameters error 
No requirements. 

6.3.4.2. 1 .3 Context Errors 

No requirements. 

6.3.4.2.2 Test Suite Files 



Test Script: 


FWK 


PCS. 


.IGCO. 


.l.scr 


Test Applet: 


FWK 


PCS. 


JGCO. 


.l.java 


Load Script: 


FWK 


PCS. 


.IGCO. 


.Lldr 


Cleanup Script: 


FWK 


PCS. 


.IGCO. 


.l.ch 


Parameter File: 


FWK 


PCS. 


.IGCO. 


.l.par 
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6.3.4.2.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Interaction with GSM Commands after 
TERMINAL PROFILE in connection with FETCH 
and TERMINAL RESPONSE 

Applet is registered to Menu Selection 

RST 

TERMINAL PROFILE 

(Profile: supports all facilities except: 
SET UP EVENT LIST, POLL INTERVAL and 
POLLING OFF) 

1- System issues a proactive command 
SETUP_MENU 

2- SELECT MF 

3- GET RESPONSE (6 Bytes) 

4- Failed SELECT File 

5- FETCH 

6- SELECT MF 

7- GET RESPONSE (6 Bytes) 

8- TERMINAL RESPONSE 




1- 91XX 

2- 9Fxx 

3- 91 XX 

4- 9404 

5- Proactive Command: 
SETUP MENU 

6- 9Fxx 

7- 9000 

8- 9000 


2 


Interaction with GSM Commands after 
ENVELOPE (MENU SELECTION) 
in connection with FETCH and TERMINAL 
RESPONSE 

Menu Entry ID = 0x01 

± t^Hi^Hi'^i iir 

2- GET RESPONSE (6 Bytes) 

3- Failed SELECT File 

4- FETCH 

5- SELECT MF 

6- GET RESPONSE (6 Bytes) 

7- TERMINAL RESPONSE 




1- 9FXX 

2- 91 XX 

3- 9404 

4- Proactive Command: 
DISPLAY TEXT 

5- 9FXX 

6- 9000 

7- 9000 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


3 


Interaction witli GSM Commands after 
TERIVIINAL RESPONSE in proactive command 
session in connection with FETCH and 
TERMINAL RESPONSE 

Menu Entry ID = 0x02 

1- SELECT MF 

2- GET RESPONSE (6 Bytes) 

3- FETCH 

4- SELECT MF 

5- GET RESPONSE (6 Bytes) 
5- Failed SELECT File 

7- TERMINAL RESPONSE 

8- SELECT MF 

9- GET RESPONSE (6 Bytes) 

10- Failed SELECT File 

11- FETCH 

12- SELECT MF 

13- GET RESPONSE (6 Bytes) 

14- TERMINAL RESPONSE 




1- 9FXX 

2- 91 XX 

3- Proactive Command: 
DISPLAY TEXT 

4- 9FXX 

5- 9000 

6- 9404 

7- 9000 

8- 9FXX 

9- 91 XX 

1 0- 9404 

1 1 -Proactive Command: 
DISPLAY TEXT 

12- 9FXX 

13- 9000 

14- 9000 



6.3.4.2.4 Test Coverage 



GRR number 


Test case number 


N1 


1, 2, 3 



6.3.5 Exception Handling 

6.3.5.1 Hide Exceptions from the ME 

Test Area Reference: FWK_EXH_HEME. 

6.3.5.1.1 Conformance Requirements 

6.3.5.1.1.1 Normal Execution 

• CRRNl : A toolkit applet may throw an exception, but this error will not be sent to the ME. 

NOTE: Because the behaviour of the SIM is not exactly defined for the above CRRN, there are no tests defined 
here yet. 

6.3.5.1 .1 .2 Parameters error 

No requirements. 

6.3.5.1 .1 .3 Context Errors 
No requirements. 

6.3.5.2 Interaction with Multiple Triggering 

Test Area Reference: FWK_EXH_IMTG. 
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6.3.5.2.1 Conformance Requirements 

6.3.5.2. 1 . 1 Normal Execution 

• CRRNl : An exception thrown by a toolkit applet, will not influence toolkit applets registered to the same event. 

6.3.5.2. 1 .2 Parameters error 

No requirements. 



6.3.5.2.1.3 

No requirements. 

6.3.5.2.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.3.5.2.3 



Context Errors 

Test Suite Files 

FWK_EXH_IMTG_1 .scr 
FWK_EXH_IMTG_1 .Java 
FWK_EXH_IMTG_1 .Idr 
FWK_EXH_IMTG_1 .clr 
FWK_EXH_IMTG_1 .par 

Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 





Load/Install 2 toolkit applets registered to 
EVENT STATUS COMMAND, 
EVENT PROFILE DOWNLOAD, 
EVENT UNRECOGNISED ENVELOPE, 
EVENT EVENT DOWNLOAD MT CALL, 
EVENT UNFORMATTED SMS PP ENV, 
EVENT UNFORMATTED SMS PP UPD, 
EVENT_UNFORMATTED_SMS_CB 

appletl : Priority= 0x01, 
applet2: Priority= 0x02, 

(i.e. appletl is triggered before applet2) 






1 


Status_Command Is sent 


1 - Appletl is triggered 

2- NullPointerException is thrown 

3- Applet2 is triggered 




2 


Proflle_Download Is sent 


1 - Appletl is triggered 

2- NullPointerException is thrown 

3- Applet2 is triggered 




3 


Unrecognlsed_Envelope Is sent 


1 - Appletl is triggered 

2- NullPointerException is thrown 

3- Applet2 is triggered 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


4 


Event_Download_MT_Call is sent 


1- Appletl is triggered 

2- NullPointerException is thrown 

3- Applet2 is triggered 




5 


Unformatted_SMS_PP_Env is sent 


1 - Appletl is triggered 

2- NullPointerException is thrown 

3- Applet2 is triggered 




6 


Unformatted_SiyiS_PP_Upd is sent 


1 - Appletl is triggered 

2- NullPointerException is thrown 

3- Applet2 is triggered 




7 


Unformatted_SMS_CB is sent 


1 - Appletl is triggered 

2- NullPointerException is thrown 

3- Applet2 is triggered 





6.3.5.2.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2,3, 4, 5, 6,7 



6.3.6 Framework Security Management 

Security Parameters 

The table that follows contains the security parameters that shall be used when the 03.48 security is required in the test 
cases developed in the current subclause. 



Parameter 


Value in hexadecimal 


KIC 


11 


KID 


11 


CNTR 


00 00 00 00 01 


Key for ciphering 


01 41 42 7F DA E8 91 A7 


Key for RC/CC/DS 


01 23 45 67 89 AB CD EF 



If a parameter is not listed explicitly in the above table, the default values of subclause 4.7.3.1 apply. 

6.3.6.1 Input Data 

Test Area Reference: FWK_FWS_INDA. 
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6.3.6.1.1 



6.3.6.1.1.1 



Conformance Requirements 
Normal Execution 



• CRRN 1 : If the SIM receives an envelope APDU containing an SMS_PP_DATADOWNLOAD BER TLV 
formatted according to GSM 03.48 [8], the SIM Toolkit Framework shall verify the security of the SMS TPDU. 

• CRRN2: The toolkit applet will only be triggered if the TAR is known and the security verified. 

• CRRN3: If the SIM receives an envelope APDU containing an SMS_CB_DATADOWNLOAD formatted 
according to GSM 03.48 [8], the SIM Toolkit Framework shall verify the security of the cell broadcast page. 



6.3.6.1.1.2 

No requirements. 

6.3.6.1.1.3 

No requirements. 

6.3.6.1.2 

Test Script: 
Test Applet: 



Load Script: 
Cleanup Script: 
Parameter File: 

6.3.6.1.3 



Parameters error 
Context Errors 

Test Area Files 

FWK_FWS_INDA_1 .scr 
FWK_FWS_INDA_1 .Java 
FWK_FWS_INDA_2.java 
FWK_FWS_INDA_3.java 
FWK_FWS_IND A_4.j ava 
FWK_FWS_INDA_1 .Idr 
FWK_FWS_INDA_1 .clr 
FWK_FWS_INDA_1 .par 

Test Procedure 



Id 



Description 



API/Frameworl< Expectation 



APDU Expectation 



Framework checks the Cryptographic 
checksum and deciphers the data 

Appletl is loaded and installed 



1-Envelope (SMS-PP) formatted is sent to 
the SIM with this features : 

Ciphering; 

Cryptographic checksum; 
No proof of receipt; 
Data = 01 



1- Appletl is triggered. 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


2 


Framework checl<s the Cryptographic 
checksum and deciphers the data 

Applet2 is installed 








1- Envelope (SMS-PP) formatted is sent to 
the SIM with this features : 

Ciphering; 

Cryptographic checksum; 
No proof of receipt; 

TAR of Applet 1 
Data = 02 

2- Envelope (SMS-PP) 03.48 formatted is sent 
to the SIM with this featuresi 

No ciphering; 

No cryptographic checksum; 
No proof of receipt; 
TAR of Applet 2 
Data = 03 


1 - Appletl is triggered 
3- Applet2 is triggered 


2- The SIM answers to the 
Envelope with status words 
9000 

The SIIVI answers to the 
Envelope with status words 
9000 


o 


f nvplnnp^^M^-PP^ fnrirmttAH with wrnnn 

^1 1 Vd Vl^wl ^JIVI w III lUIIIICIllCU Willi WW 1 VI lU 

cryptographic checksum 

No ciphering; 

Wrong Cryptographic checksum; 
No proof of receipt; 
TAR of Applet 1 
Data = 04 




1- Thp ^IK/I pnQ\A/prQ tn thp 

1 IIIC Ollvl dlloVvCIO LU LIIC 

Envelope with status words 
9000 


4 


Framework checks the Cryptographic 
checksum and deciphers the data 

Applet3 is loaded and installed 








1-Envelope (SMS-CB) formatted is sent to 
the SIM with this features: 
Ciphering; 

Cryptographic checksum; 
No proof of receipt; 
Data = 01 


1- Applets is triggered. 


1 - The SIIVI answers to the 
Envelope with status words 
9000 


5 


Triggering two different applets with different 
security on Envelope(SMS-CB) formatted 

Applet4 is installed 








1-Envelope (SMS-CB) formatted is sent to 
the SIM with this features: 
Ciphering; 

Cryptographic checksum; 
No proof of receipt; 
TAR of Applet 3 
Data = 02 


1- Applets is triggered 


2- The SIM answers to the 
Envelope with status words 
9000 




2— Envelope (SMS— CB) formatted is sent to 

the SIM with this features! 

No ciphering; 

Cryptographic checksum; 

No proof of receipt; 

TAR of Applet 4 

Data = 03 


3- Applet4 is triggered 


4- The SIM answers to the 
Envelope with status words 
9000 


6 


Envelope(SMS-CB) formatted with wrong 
cryptographic checksum 

No ciphering; 

Wrong Cryptographic checksum; 
No proof of receipt; 
TAR of Applet 3 
Data = 04 


No applet is triggered 


1 - The SIM answers to the 
Envelope with status words 
9000 
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CRR Number 


Test Case Number 


CRRN1 


1, 2, 3 


CRRN2 


3, 6 


CRRN3 


4, 5, 6 



6.3.6.2 Output Data 

Test Area Reference: FWK_FWS_OUDA. 

6.3.6.2.1 Conformance Requirements 

6.3.6.2. 1 . 1 Normal Execution 

• CRRNl: The SIM Toolkit Framework shall secure and send the response packet. 



6.3.6.2.2 Test Area Files 



Test Script: 


FWK_FWS. 


.OUDA_ 


.l.scr 


Test Applet: 


FWK_FWS. 


.OUDA_ 


.l.java 


Load Script: 


FWK_FWS. 


.OUDA_ 


.Lldr 


Cleanup Script: 


FWK_FWS_ 


_OUDA_ 


_l.ch 


Parameter File: 


FWK_FWS_ 


_OUDA_ 


-1-par 



6.3.6.2.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Envelope(SI\/IS-PP) formatted 

ciphering; 

Cryptographic checksum; 

proof of receipt response shall be sent 
using SMS-Deliver-Report ; 
no security applied to proof of receipt 
Data in plain text = "APPLETl" 


The applet Is triggered and sends a 
"Display Text" proactive command 
with the data received In the 
Envelope. 


The SIM answers to the 
Envelope with status words 
9Fxx and a PoR Is retrieved 
with a GetResponse 
command. The PoR has no 
application data. 
The SIM answers to the Get 
Response command with 
status words 91 xx to Issue a 
Display Text "APPLET1". 


2 


Envelope(SMS-PP) formatted 

ciphering; 

Cryptographic checksum; 

proof of receipt response shall be sent 
using SMS-Deliver-Report; 
no security applied to proof of receipt 
Data in plain text = "APPLETl" 


The applet posts application data. It 
does not call the 
ProactiveHandler.sendO method 


The SIM answers to the 
Envelope with status words 
9Fxx and a PoR is retrieved 
with a GetResponse 
command. The PoR has the 
application data posted by 
the application. 
The SIM answers to the Get 
Response command with 
status words 9000. 


3 


Envelope(SIUIS-PP) formatted 

Ciphering; 

Cryptographic checksum; 

proof of receipt response shall be sent 
using SMS-Deliver-Report; 
no security applied to proof of receipt 
Data in plain text = "TEST" 


The applet posts application data 
and calls the 

ProactiveHandler.sendO method to 

send a "Display Text" proactive 
command with the data received in 
the Envelope. 


The SIM answers to the 
Envelope with status words 
9Fxx and a PoR Is retrieved 
with a GetResponse 
command. The PoR has the 
application data posted by 
the application. 
The SIM answers to the Get 
Response command with 
status words 91 xx to Issue 
the Display Text "TEST". 
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Id 


Description 


API/Frameworl< Expectation 


APDU Expectation 


4 


Envelope(SMS-PP) formatted 

ciphering; 

Cryptographic checksum; 

proof of receipt response shall be sent 
using SMS^Deliver— Report ; 
proof of receipt shall be ciphered 
Data in plain text = "TEST" 


The applet posts application data 
and calls the 

ProactiveHandler.sendO method to 
send a "Display Text" proactive 
command with the data received In 
the Envelope. 


The SIM answers to the 
Envelope with status words 
9Fxx and a PoR is retrieved 
with a GetResponse 
command. The PoR has the 
application data posted by 
the application. 
The SIM answers to the Get 
Response command with 
status words 91 xx to Issue 
the Display Text "TEST". 


5 


Envelope(SMS-PP) formatted 

The Terminal Profile command shall be 
issued with the facility "'9EXX' response 
code for SIM data download error" enabled 

The Envelope (SMS-PP) formatted has to be 
issued with the following features: 
No ciphering; 

Wrong Cryptographic checksum; 

proof of receipt response shall be sent 

using SMS-Deliver-Report ; 

no security applied to proof of 

receiptData in plain text = "TEST" 


No applet Is triggered 


The SIM answers to the 
Envelope with status words 
9Exx and a PoR is retrieved 
with a GetResponse 
command. The Response 
Status Code Octet shall be 
'01'. 



6.3.6.2.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2,3,4,5 



6.3.7 Envelope Response Posting 



6.3.7.1 EVENT_CALL_CONTROL_BY_SIM 

Test Area Reference: FWK_ERP_ECCN. 

6.3.7.1.1 Conformance Requirements 

6.3.7.1.1.1 Normal Execution 

• CRRNl : The SIM Toolkit Framework can't reply busy when an Envelope(Call Control) is sent to the SIM. 



6.3.7.1.1.2 

No requirements. 

6.3.7.1.1.3 

No requirements. 

6.3.7.1.2 
Test Script: 
Test Applet: 



Load Script: 



Parameters error 

Context Errors 

Test Area Files 

FWK_ERP_ECCN_1 .scr 
FWK_ERP_ECCN_1 .Java 
FWK_ERP_ECCN_2.java 
FWK_ERP_ECCN_3.java 
FWK ERP ECCN l.ldr 
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Cleanup Script: FWK_ERP_ECCN_l.clr 
Parameter File: FWK_ERP_ECCN_1 .par 



6.3.7.1.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applet 1 Is registered on the 
EVENT_CALL_CONTROL_BY_SIM, Applet2 Is 
registered and triggered on the 
EVENT_MENU_SELECTION. 








1- Applet2 invokes the method send () and no 
fetch is performed 

2- Envelope (Call Control) is sent to the 

SIM 

3- Appletl calls the method 

EnvelopeResponseHandler . postASBERTLV ( ) to 
change any incoming dialling number into 

ill A A 
+11 ZZ J J 44 . 


Applet2 is suspended 
Appletl is triggered. 


The SIM answer 9Fxx to the 
Envelope(Call Control) 

The dialling number is 
retrieved with a 
GetResponse command. 
The SIM answers to the Get 
Response command with 
status words 91 xx. 




4-A Fetch command is sent to the SIM 








5-A Terminal Response command is sent to 
the SIM 


Applet2's execution sliall continue. 






5-Delete appletl & applet2 








7-Install applets 






2 


Applet 3 Is registered on both the events 
EVENT CALL CONTROL BY SIM and 
EVENT_MENU_SELECTION. 

1- Envelope Menu Selection is sent to the 
SIM. 

2- Applet3 invokes the method send () and no 
fetch is performed) 


Applets is triggered on the 
EVENT_MENU_SELECTION 

Applets is suspended on the send() 
method 






3- Envelope (Call Control) is sent to the 

SIM 

4- Applet3 calls the method 

EnvelopeResponseHandler .postASBERTLV () to 
change any incoming dialling number into 
+11 22 33 44. 


Applets is triggered on the 
EVENT CALL CONTROL BY SI 
M. 


The SIM answer 9Fxx to the 
Envelope(Gall Control) 

The dialling number is 
retrieved with a 
GetResponse command. 




5-A Fetch command is sent to the SIM 




The SIM answers to the Get 
Response command with 
status words 91 xx. 




6-A Terminal Response command is sent to 
the SIM 


The AppletS's execution shall 
continue. 
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6.3.7.1.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 



6.3.7.2 EVENT_MO_SHORT_MESSAGE_CONTROL_BY_SIM 

Test Area Reference: FWK_ERP_EMCN. 



6.3.7.2.1 



6.3.7.2.1.1 



Conformance Requirements 
Normal Execution 



• CRRNl : The SIM Toolkit Framework can't reply busy when an Envelope(MO-Short Message Control) is sent to 
the SIM. 



6.3.7.2.1.2 

No requirements. 

6.3.7.2.1.3 

No requirements. 

6.3.7.2.2 

Test Script: 
Test Applet: 



Load Script: 
Cleanup Script: 
Parameter File: 



Parameters error 
Context Errors 

Test Area Files 

FWK_ERP_EMCN_1 .scr 
FWK_ERP_EMCN_1 .Java 
FWK_ERP_EMCN_2.java 
FWK_ERP_EMCN_3 .j ava 
FWK_ERP_EMCN_1 .Idr 
FWK_ERP_EMCN_1 .cb- 
FWK_ERP_EMCN_1 .par 
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6.3.7.2.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Applet 1 is registered on the 
EVENT_MO_SHORT_MESSAGE_CONTROL_B 
Y SIM; Applet2 is registered and triggered on 
the EVENT_MENU_SELECTiON. 








1- Applet2 invokes the method send () and no 
fetch is performed) 

2- Envelope (MO-SM control) is sent to the 
SIM 

3- Appletl calls the method 
EnvelopeResponseHandler . postASBERTLV ( ) to 
change any incoming TP_Destination_Address 
and any RP_Destination_Address of the 
bervice t^entre into +ll zz 44 


Applet2 is suspended 
Applet 1 is triggered. 


The SIM answers 9Fxx to 
the Envelope(MO-Short 
Message Control) 

The 

TP_Destination_Address is 
retrieved with a 
GetResponse command. 




4- A Fetch command is sent to the SIM 

5- A Terminal Response command is sent to 
the SIM 




The SIM answers to the Get 
Response command with 
status words 91 xx. 




5— Delete appletl & applet2 


The Applet's execution shall 
rnntini ip 

Owl 1 III lUC 






7-Install applets 






2 


Applet 3 is registered on both the events 
EVENT l\10 SHORT MESSAGE CONTROL B 
Y_SIM and EVENT_MENU_SELECTION. 

1-Applet3 invokes the method send () and no 
fetch is performed) 


Applet 3 Is suspended on the 
send() method 






2- Envelope (MO-SM control) is sent to the 
SIM 

3- Applet3 calls the method 
EnvelopeResponseHandler . postASBERTLV ( ) to 
change any incoming TP_Destination_Address 
and any RP_Destination_Address of the 
Service Centre into +11 22 33 44. 


Applets is triggered on the 
EVENT MO SHORT MESSAGE 
CONTROL_BY_SIM. 


The SIM answers 9Fxx to 
the Envelope{MO-Short 
Message Control) 

The 

TP_Destlnation_Address Is 
retrieved with a 
GetResponse command. 

The SIM answers to the Get 
Response command with 
status words 91 xx. 




4-A Fetch command is sent to the SIM 








5-A Terminal Response command is sent to 
the SIM 


The AppletS's execution shall 
continue. 
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6.3.7.2.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1,2 



6.3.7.3 EVENT_UNRECOGNIZED_ENVELOPE 

Test Area Reference: FWK_ERP_EUEN. 

6.3.7.3.1 Conformance Requirements 

6.3.7.3.1.1 Normal Execution 

• CRRN 1 : The EnvelopeResponseHandler is available for the E VENT_UNRECOGNIZED_EN VELOPE. 

6.3.7.3.1.2 Parameters error 

No requirements. 



6.3.7.3.1.3 

No requirements. 

6.3.7.3.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.3.7.3.3 



Context Errors 

Test Area Files 

FWK_ERP_EUEN_1 .scr 
FWK_ERP_EUEN_1 .Java 
FWK_ERP_EUEN_1 .Idr 
FWK_ERP_EUEN_1 .clr 
FWK_ERP_EUEN_1 .par 

Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


An applet triggered on the 
EVENT_UNRECOGNIZED_ENVELOPE calls the 
EnvelopeResponseHandler.postO method 


The post() method returns no 
exception 


The SIM answers to the 
Envelope with status words 
9Fxx. The data retrieved 
with the GetResponse 
command are the ones 
posted by the applet. 



6.3.7.3.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1 



6.3.8 Toolkit Installation 
6.3.8.1 Timers Allocation 

Test Area Reference: FWK_TIN_TMAL. 
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6.3.8.1.1 Conformance Requirements 

6.3.8.1 .1 .1 Normal execution 

• CRRN 1 : One toolkit applet can register to several timers, but a timer can only be allocated to one toolkit applet. 

6.3.8.1 .1 .2 Parameters error 

No requirements. 

6.3.8.1.1.3 Context errors 

• CRRCl: Allocated timers shall not exceed the maximum number of timers allowed for this applet instance 
defined during installation. 

• CRRC2: The total number of timers allocated for all the applets shall not exceed 8. 

6.3.8.1.2 Test suite files 



Test Script: 


FWK 


TIN. 


TMAL. 


.l.scr 


Test Applet: 


FWK 


TIN 


TMAL_ 


_l.java 




FWK_ 


_TIN_ 


_TMAL_ 


_2.java 




FWK 


_TIN_ 


_TMAL_ 


_3.java 


Load Script: 


FWK 


TIN 


.TMAL. 


.l.ldr 


Cleanup Script: 


FWK 


TIN 


.TMAL. 


.l.ch 


Parameter File: 


FWK 


TIN 


.TMAL. 


.l.par 
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6.3.8.1.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


More than 8 timers at the instantiation of 
appletl : check that appletl is not installed or 
that it is not possible to allocate more than 8 
timers. 

Install for install of appletl with 

ILLCl-A. -LlLt LllLt ^ L,-LiLt^i-0 CIJ L\.Jk^ClL.s^ KJ. ■ 

appletl is triggered: we allocate 9 timers 
appletl is selected 


Shall throw a ToolkitException with 
reason NO_TIMER_AVAILABLE 
only on the 9* allocateTimer() 


The SIIVI answers to the 
Envelope with status words 
90 00 

2 behaviours may be 

expected : 
1. appletl is not found, 
status word 6X XX 
2. appletl has been 
installed and only 8 timers 
are allocated 




Reset the card and delete instance of appletl 






2 


Good installation of applet2 

Install for install of applet2 (maximum 4 
timers allocated) . 




The SIM answers to the 
Envelope with status words 
90 00 


3 


Allocate 4 timers 
Applet2 


No exception shall be thrown. 




4 


Allocate one more timer 
Applet2 


Shall throw a ToolkitException with 
reason NO_TIMER_AVAILABLE 




5 


Good installation of applets 

Install for install of applets (maximum 8 
timers allocated) . 




The SIM answers to the 
Envelope with status words 
90 00 


6 


Allocate 4 timers 
Applets 


No exception shall be thrown. 




7 


Allocate one more timer 
Applets 


Shall throw a ToolkitException with 
reason NO_TIMER_AVAILABLE 




8 


Check that each timerld (allocated by applet2 
and applets) is between 1 and 8 and is different 
from each other 







6.3.8.1 .4 Test Coverage 



CRR number 


Test case number 


N1 


2, 3, 8 


C1 


1,7 


C2 


4, 5, 6 



6.3.8.2 Item Identifier 

Test Area Reference: FWK_TIN_mD. 
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6.3.8.2.1 Conformance Requirements 

6.3.8.2. 1 . 1 Normal execution 

• CRRNl: If the requested item identifier in the range [1-127] is not already allocated, then this item identifier 
shall be allocated to the current applet. 

• CRRN2: If the requested item identifier is '00', the card shall take the first free value in the range [128,255]. 

6.3.8.2. 1 .2 Parameters error 

• CRRPl : If the requested item identifier is in the range [128,255], then the card shall reject the install command. 

6.3.8.2.1.3 Context errors 

• CRRCl: If the requested item identifier in the range [1-127] is already allocated, then the card shall reject the 
install command. 



6.3.8.2.2 

Test Script: 
Test Applet: 



Load Script: 
Cleanup Script: 
Parameter File: 

6.3.8.2.3 



Test suite files 

FWK_TIN_ITID_1 .scr 

FWK_TIN_mD_l .java 

FWK_TIN_mD_2.java 

FWK_TIN_mD_3.java 

FWK_TlN_lTID_l.ldr 

FWK_TlN_ITlD_l.ck 

FWK_TIN_ITID_1 .par 

Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Bad Installation of appletl 

Install for install of appletl. The 
following parameters item Id equal to 128 

appletl is selected 




appletl is not found, status 
word 6XXX 


2 


Good Installation of appletl 

Install for install of appletl . item Id = 
1 for the first menu and 127 for the 
second one 

A Terminal Profile is sent to the card 
with only PROFILE_DOWNLOAD, 
SMS_PP_DOWNLOAD, MENU_SELECTION, 
SET_UP_MENU and COMMAND_RESULT facilities. 




The SIM answers to the 
Envelope with status words 
91 XX to send back to the ME 
the 2 new menus. 

The menus are 
(position/item Id/text) 
01/01/menu11 
02/127/menu12 


3 


Bad Installation of applet2 

Item identifier already allocated 

Install for install of applet2. 
item Id = 127 

applet2 is selected 




applet2 is not found, status 
word 6X XX 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


4 


Good instaiiation of appiet2 

Install for install of applet2. 
item Id = 




The SIM answers to the 
Envelope with status words 
91 XX to send back to the ME 
the 3 menus. 

The menus are 
01/01/menu11 
02/127/menu12 
03/128/menu21 


5 


Good installation of applets 

Install for install of applets, 
item Id = 




The SIM answers to the 
Envelope with status words 
91 XX to send back to the ME 
the 4 menus. 

The menus are 

01/01/menu11 

02/127/menu12 

03/128/menu21 

04/129/menu31 


6 


Good delete and installation of applet2 

Delete instance of applet2 

Perform a RESET and a Terminal Profile 
with the facilities of PROFILE_DOWNLOAD, 
SMS-PP_DATA_DOWNLOAD, MENU_SELECTION, 
COMMAND_RESULT and SET_UP_MENU 

Install for install of applet2. 
item Id = 




The SIM answers to the 
Terminal Profile with status 
words 91 XX to send back to 
the ME the 3 menus. 

The menus are 
01/01/menu11 
02/127/menu12 
03/129/menu31 

The SIM answers to the 
Envelope with status words 
91 XX to send back to the ME 
the 4 menus. 

The menus are 

01/01/menu11 

02/127/menu12 

03/128/menu21 

04/129/menu31 



6.3.8.2.4 Test Coverage 



CRR number 


Test case number 


N1 


2 


N2 


4, 5, 6 


PI 


1 


CI 


3 



6.3.8.3 Item Position 

Test Area Reference: FWK_TIN_ITPO. 
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6.3.8.3.1 Conformance Requirements 

6.3.8.3.1.1 Normal execution 

• CRRNl: The position of the new menu entries is an absolute position among the existing ones. 

• CRRN2: If the position identifier is OOh, the menu shall have the last position 



6.3.8.3.1.2 

No requirements. 

6.3.8.3.1.3 

No requirements. 

6.3.8.3.2 

Test Script: 
Test Applet: 



Load Script: 
Cleanup Script: 
Parameter File: 



Parameters error 
Context errors 
Test suite files 

FWK_TIN_ITP0_1 .scr 
FWK_TIN_ITPO_l .Java 
FWK_TIN_ITPO_2.java 
FWK_TIN_ITPO_3.java 
FWK_TIN_ITPO_l .Idr 
FWK_TIN_ITPO_l .clr 
FWK_TIN_ITPO_l .par 
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6.3.8.3.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Installation of appletl 

Perform Install for install of 
appletl . Position/Itemid 
01/01 
02/02 

A Terminal Profile is sent to the card 




The menus are 
(position/item Id/text) 
01/01/menu11 
02/02/menu12 


2 


Installation of applet2 

Perform Install for install of applet2. 

Posit ion/ It emid 

03/03 

04/04 




The SIM answers to the 
Envelope with status words 
91 XX to send back to the ME 
the 4 menus. 

The menus are 
(position/item Id/text) 
01/01/menu11 
02/02/menu12 

03/03/menu21 
04/04/menu22 


3 


Installation of applet3 

Perform Install for install of applet3. 

Position/ Itemid 

00/05 




The SIM answers to the 
Envelope with status words 
91 XX to send back to the ME 
the 5 menus. 

The menus are 

(position/item Id/text) 

01/01/menu11 

02/02/menu12 

03/03/menu21 

04/04/menu22 

05/05/menu31 



6.3.8.3.4 Test Coverage 

NOTE: As Item Position management is not fully specified in the GSM 03.19 [7] or GSM 03.48 [8] all possible 
tests cannot be performed. 



CRR number 


Test case number 


N1 


1,2 


N2 


3 



6.3.8.4 Maximum Text Length for a menu entry 

Test Area Reference: FWK_TIN_MLME. 

6.3.8.4.1 Conformance Requirements 

6.3.8.4.1.1 Normal execution 

• CRRN 1 : The maximum length of item text string is defined at the installation of the toolkit applet. 

6.3.8.4. 1 .2 Parameters errors 

• CRRPl : If initMeni^lntry length parameter is greater than the allocated space (Maximum Text Length for a 
menu entry), then a ToolldtException ALLOWED_LENGTH_EXCEEDED is thrown. 

• CRRP2: If changeMenuEntry length parameter is greater than the allocated space (Maximum Text Length for a 
menu entry), then a ToolldtException ALLOWED_LENGTH_EXCEEDED is thrown. 
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6.3.8.4.1.3 

No requirements. 

6.3.8.4.2 
Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 



Context errors 

Test suite files 

FWK_T1N_MLME_1 .scr 
FWK_TIN_MLME_1 .java 
FWK_TIN_MLME_1 .Idr 
FWK_TIN_MLME_1 .clr 
FWK_TIN_MLME_1 .par 



6.3.8.4.3 



Test Procedure 



Id 



Description 



API / Framework Expectation 



APDU Expectation 



Installation of applet with 2 menus not 
exceeding the maximum text length 

Install one applet with 2 menu entries 
allowed and max. text length equal to 10. 
initMenuEntry defined at the install 
(install) command 

MenuEntry = "MenuEntryl " , "MenuEntry2" 

Offset = 
Length = 10 
NextAction = '00' 
HelpSupported = false 
IconQualif ier = '00' 
Iconldentif ier = 



initMenuEntry with a too large length 

InitMenuEntry with length equal to 11 

MenuEntry = " MenuEntry03" 

Offset = 

Length = 11 

NextAction = '00' 

HelpSupported = false 

IconQualif ier = '00' 

Iconldentif ier = 



ToolkitException 

ALLOWED_LENGTH_EXCEEDED 
is thrown 



InitMenuEntry with a right length 

InitMenuEntry with length parameter equal 

to 10 

MenuEntry = " MenuEntry3" 
Offset = 
Length = 10 
NextAction = '00' 
HelpSupported = false 
IconQualif ier = '00' 
Iconldentif ier = 



a SET UP MENU (2 items) 
is issued witli TLV item 
lengtli equal to 1 1 (Identifier 
+ Text string of item) 



changeMenuEntry with a right length 



Appletl is triggered by a 
EVENT_MENU_SELECTION . 
ChangeMenuEntry of menu 1, 
parameter equal to 10 
Id = '01' 

MenuEntry = "MenuEntry 4" 
Offset = 

Length = menuEntry . length 
NextAction = 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 

Return from processToolkit 



with length 



a SET UP IVIENU (2 items) 
is issued with TLV item 
length equal to 1 1 (Identifier 
+ Text string of item) 
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Id 


Description 


API / Framework Expectation 


APDU Expectation 


5 


changeMenuEntry witli a too large length 

Appletl is triggered by a 
EVENT_MENU_SELECTION . 

ChangeMenuEntry of menu 1, with length 
parameter equal to 11 
Id = ' 02 ' 

MenuEntry = "MenuEntryOS " 

Offset = 

Length = menuEntry . length 
NextAction = 
HelpSupported = false 
IconQualif ier = 
Iconldentif ier = 

Return from processToolkit 


ToolkitException 

ALLOWED_LENGTH_EXCEEDED 
is thrown 


Shall not receive a SET UP 
MENU different from the 
previous one 



6.3.8.4.4 Test Coverage 



CRR number 


Test case number 


CRRN1 


1,3,4 


CRRP1 


2 


CRRP2 


5 



6.3.8.5 Maximum number of menu entries 

Test Area Reference: FWK TIN NBME. 



6.3.8.5.1 



6.3.8.5.1.1 



Conformance Requirements 

Normal execution 



• CRRNl: The maximum number of menu entries is defined at the installation of the toolkit applet and can be the 
maximum number of successful invocations of the method initMenuEntry. 



6.3.8.5.1.2 



Parameters errors 



• CRRPl: If the menu entry cannot be initialized (e.g. no more item data in applet loading parameter), a 
ToolkitException with the REGISTRY_ERROR reason code is thrown. 



6.3.8.5.1.3 

No requirements. 

6.3.8.5.2 
Test Script: 
Test Applet: 

Load Script: 
Cleanup Script: 
Parameter File: 



Context errors 

Test suite files 

FWK_TIN_NBME_l.scr 
FWK_TIN_NBME_1 .Java 
FWK_TIN_NBME_2.java 
FWK_TIN_NBME_1 .Idr 
FWK_TIN_NBME_1 .ck 
FWK_TIN_NBME_1 .par 
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6.3.8.5.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


Installation of applet with 3 menus 

Install (install) applet with max. number 
of menu entry is '3', defined at the 
install (install) command. 

InitMenuEntry for each menu entry allowed 

(3 times) 

MenuEntry = "menul", "menu2", "menu3" 

Offset = 
Length = 5 
NextAction = '00' 
HelpSupported = false 
IconQualif ier = '00' 
Iconldentif ier = 


No Exception is thrown 




2 


init of a 4'*' menu 

InitMenuEntry one more time 
MenuEntry = "menu4" 
Offset = 
Length = 5 
NextAction = '00' 
HelpSupported = false 
IconQualif ier = '00' 
Iconldentif ier = 


ToolkitException 
REGISTRY_ERROR is thrown 


SETUPIVIENU (3 Items) is 
issued with TLV item length 
equal to 6 (Identifier + Text 
string of item) 


3 


Installation of 2"'' applet with menu 

Install (install) another applet, with 
max. number of menu entry is '0', defined 
at the install (install) command. 

InitMenuEntry once 
MenuEntry = "menul" 
Offset = 
Length = 5 
NextAction = '00' 
HelpSupported = false 
IconQualif ier = '00' 
Iconldentif ier = 


ToolkitException 
REGISTRY_ERROR is thrown 


Shall not receive a SET UP 
IVIENU different from the 
previous one 



6.3.8.5.4 Test Coverage 



CRR number 


Test case number 


CRRN1 


1 


CRRP1 


2, 3 



6.3.8.6 Access Domain 

Test Area Reference: FWK_TIN_ACDO. 

6.3.8.6.1 Conformance Requirements 

6.3.8.6.1.1 Normal execution 

• CRRNl: The Access Domain parameter indicates the mechanism used to control the applet instance access to 
the GSM file System ('00' means full access to the GSM File System, 'FF' means no access to the GSM File 
System). 

6.3.8.6. 1 .2 Parameters errors 

• CRRPl : If the Access Domain Parameter requested is not supported, the card shall return the Status Word 
'6A80', incorrect parameters in data field, to the InstaU(Install) command. 
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• CRRP2: If an applet with Access Domain Parameter 'FF' (i.e. No Access to the GSM File System) tries to access 
a GSM file (e.g. invoke the updateBinary(..) method) the framework shall throw a SIMViewException with a 
AC NOT FULFILLED reason. 



6.3.8.6.1.3 

No requirements. 



Context errors 



6.3.8.6.2 

Test Script: 
Test Applet: 



Load Script: 
Cleanup Script: 
Parameter File: 



Test suite files 

FWK_TIN_ACDO_l .scr 
FWK_TIN_ACD0_1 .Java 
FWK_TIN_ACDO_2.java 
FWK_TIN_ACDO_3.java 
FWK_TIN_ACDO_l .Idr 
FWK_TE^_ACDO_l .clr 
FWK_TIN_ACDO_l .par 



6.3.8.6.3 



Test Procedure 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



Install (install) appletl with: 

- Length of Access Domain field value is 
' 1 ' 

- Access Domain Parameter value is '00' 
(full access to the GSM File System) 

Install (install) applet2 with: 

- Length of Access Domain field value is 
' 1 ' 

- Access Domain Parameter value is 'FF' 
(No access to the GSM File System) 



Install (install) applets with: 

- Length of Access Domain field value is 
' 1 ' 

- Access Domain Parameter value is '00' 
(full access to the GSM File System) 
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APnil FYnpptfltinn 


1 


readBlnary/readRecord method with full 


1 to 4- no exception is thrown 






Access Domain Parameter 








1- Select EF-TARU file whose Read access 


O" oiivi V lywcxocpiiuri 






AC_NOT_FULFILLED is thrown 






condition is ALWAYS 








Perform the readBinary method: 








fileOffset = 








resp = abRead[] 








respOffset = 








respLength = 3 








2- Select EF-SMS file whose Read access 








condition is CHVl 








Perform the readRecord method: 








recNumber = 1 








mode = REC_ACC_MODE_ABSOLUTE_CURRENT 








recOffset = 








resp = abRead[] 








respOffset = 








respLength = 3 








3- Select EF-TRAC file whose Read access 








condition is CHV2 








Perform the readBinary method: 








fileOffset = 








resp = abRead[] 








respOffset = 








respLength = 3 








4- Select EF-SUME file Read access 








condition is ADMO 








Perform the readBinary method: 








fileOffset = 








resp = abRead[] 








respOffset = 








respLength = 3 








D oexecT^ iijr iLNK rixe wnose Keau access 








condition is NEVER 








Perform the readBinary method: 








fileOffset = 








resp = abRead[] 








respOffset = 








respLength = 3 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


2 


updateBinary/updateRecord method with full 
Access Domain Parameter 

For each case, send an Envelope that 
triggers the applet with the 
EVENT_UNFORMATTED_SMS_PP_ENV event . 

1- Select EF-TNR file whose Update access 
condition is ALWAYS 

Perform the updateBinary method: 

fileOffset = 

resp = abUpdate [FFFFFF] 

respOffset = 

respLength = 3 

2- Select EF-SMS file whose Update access 

condition is CHVl 

Perform the updateRecord method: 

recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
recOffset = Oresp = abUpdate [ ] 
respOffset = 
respLength = 3 

3- Select EF-FDN file whose Update access 
condition is CHV2 

Perform the updateBinary method: 
recNumber = 1 

mode = REC_ACC_MODE_ABSOLUTE_CURRENT 
recOffset = 
resp = abUpdate [] 
respOffset = 
respLength = 3 

4- Select EF-SUME file Update access 
condition is ADMO 

Perform the updateBinary method: 

fileOffset = 
resp = abUpdate [] 
respOffset = 
respLength = 3 

5- Select EF-TNU file whose Update access 
condition is NEVER 

Perform the updateBinary method: 
fileOffset = 
resp = abUpdate [] 
respOffset = 
respLength = 3 


1 to 4- no exception is thrown 

5- SIMViewException 
AC_NOT_FULFILLED is thrown 




3 


invalidate method with full Access Domain 
Parameter 

1- Select EF-TNR file whose Invalidate 
access condition is ALWAYS 

Perform the invalidate method 

2- Select EF-TIAC file whose Invalidate 
access condition is CHVl 

Perform the invalidate method 

3- Select EF-ADN file whose Invalidate 
access condition is CHV2 

Perform the invalidate method 

4- Select EF-SUME file Invalidate access 
condition is ADMO 

Perform the invalidate method 

5- Select EF-CNIV file whose Invalidate 
access condition is NEVER 

Perform the invalidate method 


1 to 4- no exception is thrown 

5- SilVIViewException 
AC_NOT_FULFILLED is thrown 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


4 


reiiabilitate metliod with full Access Domain 
Parameter 

1- Select EF-TNR file whose Rehabilitate 
access condition is ALWAYS 

Perform the rehabilitate method 

2- Select EF-IMSI file whose Rehabilitate 
access condition is CHVl 

Perform the rehabilitate method 

3- Select EF-ADN file whose Rehabilitate 
access condition is CHV2 

Perform the rehabilitate method 

4- Select EF-SUME file Rehabilitate access 
condition is ADMO 

Perform the rehabilitate method 

5- Select EF-CNRI file whose Rehabilitate 
access condition is NEVER 

Perform the rehabilitate method 


1 to 4- no exception is thrown 

5- SIMViewException 
AC_NOT_FULFILLED is thrown 




5 


increase metliod with full Access Domain 
Parameter 

1- Select EF-CNU file whose Increase 
access condition is ALWAYS 
Perform the increase method: 

incr = ablncreaseValue [ ] 
incrOffset = 
resp = abRead[] 
respOffset = 

2- Select EF-ACM file whose Increase 
access condition is CHVl 

Perform the increase method: 
incr = ablncreaseValue [ ] 
incrOffset = 
resp = abRead[] 
respOffset = 

3- Select EF-CIAC file whose Increase 
access condition is CHV2 

Perform the increase method: 
incr = ablncreaseValue [ ] 
incrOffset = 
resp = abRead[] 
respOffset = 

4- Select EF-CIAA file Increase access 

condition is ADMO 

Perform the increase method: 

incr - ablncreaseValue [ ] 

incrOffset = 

resp = abRead[] 

respOffset = 

5- Select EF-CNR file whose Increase 
access condition is NEVER 

Perform the increase method 


1 to 4- no exception is thrown 

5- SIMViewException 
AC_NOT_FULFILLED is thrown 
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Id 


Description 


API/Frameworl< Expectation 


APDU Expectation 


6 


readBinary method witli no Access Domain 
Parameter 

Send an Envelope that triggers the applet 
with the EVENT_UNFORMATTED_SMS_PP_ENV 
event . 

Select EF-TARU file whose Read access 

condition is ALWAYS 

Perform the readBinary method: 

fileOffset = 

resp = abRead[] 

respOffset = 

respLength = 3 

t 


SIMViewException 
AC_NOT_FULFILLED is thrown 




7 


updateRecord method with no Access Domain 
Parameter 

Send an Envelope that triggers the applet 
with the EVENT_UNFORMATTED_SMS_PP_ENV 
event . 

Select EF-SMS file whose Update access 

condition is CHVl 

Perform the updateRecord method: 

fileOffset = 

resp = abUpdate [ ] 

respOffset = 

respLength = 3 


SIMViewException 
AC_NOT_FULFILLED Is thrown 




8 


Invalidate method with no Access Domain 
Parameter 

Send an Envelope that triggers the applet 
with the EVENT_UNFORMATTED_SMS_PP_ENV 
event . 

Select EF-ADN file whose Invalidate access 

condition is CHV2 

Perform the invalidate method 


SIMViewException 
AC_NOT_FULFILLED is thrown 




9 


rehabilitate method with no Access Domain 
Parameter 

Send an Envelope that triggers the applet 
with the EVENT_UNFORMATTED_SMS_PP_ENV 
event . 

Select EF-SUME file Rehabilitate access 

condition is ADMO 

Perform the rehabilitate method 


SIMViewException 
AC_NOT_FULFILLED Is thrown 




10 


increase method with no Access Domain 
Parameter 

Send an Envelope that triggers the applet 
with the EVENT_UNFORMATTED_SMS_PP_ENV 
event . 

Select EF-CNR file whose Increase access 

condition is NEVER 

Perform the increase method 


SIMViewException 
AC_NOT_FULFILLED Is thrown 

Applet2 finalizes 
Applets restore EF-SUME 





6.3.8.6.4 Test Coverage 

NOTE: As Item Position management is not fully specified in the GSM 03.19 [7] or GSM 03.48 [8] all possible 
tests cannot be performed. 
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CRR number 


Test case number 


CRRN1 


1, 2, 3, 4, 5 


CRRP1 


Not tested 


CRRP2 


6, 7, 8, 9, 10 



6.3.8.7 Priority Level 

Test Area Reference: FWK TIN PRLV. 



6.3.8.7.1 
6.3.8.7.1.1 



Conformance Requirements 
Normal execution 



• CRRNl: The priority specifies the order of activation of an applet compared to the other applet registered to the 
same event ('01': Highest priority level, 'FF': Lowest priority level). 

• CRRN2: If two or more applets are registered to the same event and have the same priority level, the applets are 
activated according to their installation date (i.e. the most recent applet is activated first). 



6.3.8.7.1.2 

No requirements. 

6.3.8.7.1.3 

No requirements. 

6.3.8.7.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.3.8.7.3 



Parameters errors 
Context errors 
Test suite files 

FWK_TlN_PRLV_x.scr, x from 1 to 12 

FWK_TlN_PRLV_x.java, x from 1 to 12, 8A, 8B, 9A, 9B, lOA, lOB 
FWK_TIN_PRLV_x.ldr, x from 1 to 12 
FWK_TIN_PRLV_x.clr, x from 1 to 12 

FWK_TIN_PRLV_x.par, x from 1 to 12, 8A, SB, 9A, 9B, lOA, lOB 
Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 





All applets are registered on an 
EVENT UNFORMATTED SMS PP ENV event 






1 


Trigger 2 applets with 2 different maximum 
Priority Levels 

Install (install) appletl with priority 
level '2' and applet2 with priority level 
'1', from package fwk_tin_prlv_l . 

Send an Envelope that triggers the 2 
applets with the 

EVENT_UNFORMATTED_SMS_PP_ENV event . 
Delete applets instances and packages 


A static variable is used to validate 

triggering order: applet2 is 
triggered before appletl 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


2 


Trigger 2 applets with 2 different maximum 
Priority Levels 

Install (install) appletl with priority 
level '1' and applet2 with priority level 
' 2 ' , front package fwk tin prlv 2 . 

Send an Envelope that triggers the 2 
applets with the 

EVENT_UNFORMATTED_SMS_PP_ENV event . 

Delete applets instances and packages 


A static variable is used to validate 
triggering order: appletl is 
triggered before applet2. 




3 


Trigger 2 applets with 2 different Priority 
Levels 

Install (install) appletl with priority 
level '80' and applet2 with priority level 
' 7F ' , from package fwk_tin_prlv_3 . 

Send an Envelope that triggers the 2 
applets with the 

EVENT_UNFORMATTED_SMS_PP_ENV event . 
Delete applets instances and packages 


A static variable is used to validate 

triggering order: applet2 is 
triggered before appletl 




4 


Trigger 2 applets with 2 different Priority 
Levels 

Install (install) appletl with priority 
level '7F' and applet2 with priority level 
'80', from package fwk_tin_prlv_4 . 

Send an Envelope that triggers the 2 
applets with the 

EVENT_UNFORiXIATTED_SMS_PP_ENV event . 

Delete applets instances and packages 


A static variable is used to validate 
triggering order: applet2 is 
triggered before appletl 




5 


Trigger 3 applets with the same Priority Level 

Install (install) applet 1, 2, 3 in this 
order with same priority level from 
package fwk_tin_prlv_5 . 

Send an Envelope that triggers the 3 
applets with the 

EVENT_UNFORMATTED_SMS_PP_ENV event . 
Delete applets instances and packages. 


A static variable is used to validate 
triggering order: applets is 
triggered before applet2, and 
applet2 is triggered before appletl . 




6 


Trigger 2 applets from 2 classes, with 2 
different Priority Level 

Install (install) appletl from class A 
with priority level '2' 
Install (install) applet2 from class B 
with priority level ' 1 ' 

Send an Envelope that triggers the 2 
applets with the 

EVENT_UNFORMATTED_SMS_PP_ENV event . 
Delete applets instances and packages 


A static variable is used to validate 
triggering order: applet2 is 
triggered before appletl 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


7 


Trigger 2 applets from 2 classes, with the same 
Priority Level 

Install (install) appletl from class A 
with priority level ' 1 ' 

Install (install) applet2 from class B 
with priority level ' 1 ' 

Send an Envelope that triggers the 2 

applets with the 

EVENT_UNFORMATTED_SMS_PP_ENV event . 
Delete applets instances and packages 


A static variable is used to validate 
triggering order: applet2 is 
triggered before appletl 




8 


Trigger 2 applets from 2 packages, with 2 
different Priority Level 

Install package fwk_tin_prlv_8 . 
Install (install) appletl from package 
f wk_tin_prlv_8A with priority level '2' 
Install (install) applet2 from package 
f wk_tin_prlv_8B with priority level '1' 

Send an Envelope that triggers the 2 
applets with the 

EVENT_UNFORMATTED_SMS_PP_ENV event . 
Delete applets instances ad packages 


A static variable is used to validate 
triggering order: applet2 is 
triggered before appletl 




9 


Trigger 2 applets from 2 packages, with the 
same Priority Level 

Install package f wk_tin_prlv_9 . 
Install (install) applets 1 from package 
f wk_tin_prlv_9A and applet2 from package 
f wk_tin_prlv_9B in this order, with same 

priority level 

Send an Envelope that triggers the 2 
applets with the 

EVENT_UNFORMATTED_SMS_PP_ENV event . 
Delete applets instances and packages 


A static variable is used to validate 
triggering order: applet2 is 
triggered before appletl 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


10 


Trigger 4 applets from 2 packages 

1- Install packages f wk_tin_prlv_l , 
fwk_tin_prlv_10A and f wk_tin_prlv_l OB . 
Install (install) 2 applets 1 then 2 from 
package f wk_tin_prlv_l OA, with 
respectively priority levels 1 and 2 . 

Send an Envelope that triggers the 2 
applets with the 

EVENT_UNFORiXIATTED_SMS_PP_ENV event . 

2- Install (install) 2 applets 3 then 4 
from package fwk_tin_prlv_10B, with 
respectively priority levels 1 and 2. 

Send an Envelope that triggers the 4 

applets . 

Delete applets instances and packages 


1- A static variable is used to 
validate triggering order: appletl is 
triggered before applet2 

2- Applets is triggered before 
applets 1 , 4, then 2. 




11 


Trigger 4 applets with the same Priority Level 
then delete them one after another and trigger 
them each time 

1- Install (install) appletl, 2, 3, 4 in 
this order with same priority level from 
package fwk_tin_prlv_ll . 

Send an Envelope that triggers the 4 
applets with the 

EVENT_UNFORMATTED_SMS_PP_ENV event . 

Delete applet instance 4 

2- Send an Envelope that triggers the 3 
applets with the 

EVENT_UNFORiXIATTED_SMS_PP_ENV event . 

Delete applet instance 3 

3- Send an Envelope that triggers the 2 
applets with the 

EVENT_UNFORMATTED_SMS_PP_ENV event . 

Delete remaining applet instances and 
packages 


1- A static variable is used to 
validate triggering order: applets 
are triggered in order 4, 3, 2, 1 . 

2- Applets are triggered in order 3, 
2, 1. 

3- Applets are triggered in order 2, 
1. 
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Id 



Description 



API/Framework Expectation 



APDU Expectation 



12 



Trigger 5 applets with different Priority Levels, 
alternating install and delete 

1- Install (install) applets 1, 2, 3, 4 in 
this order with respective priority levels 
1, 2, 1, 2 

Send an Envelope that triggers the 4 
applets with the 

EVENT UNFORMATTED SMS PP ENV event. 



2- Delete applet instance 1 and install 
(install) applets with priority level 2 

Send an Envelope that triggers the 4 
applets with the 

EVENT UNFORMATTED SMS PP ENV event. 



3- Re-install (install) appletl with 

priority level 1 

Send an Envelope that triggers the 5 
applets with the 

EVENT UNFORMATTED SMS PP ENV event. 



1- A static variable is used to 
validate triggering order: applets 
are triggered in order 3, 1 , 4, 2 



2- Applets are triggered in order 3, 
5, 4, 2 



3- Applets are triggered in order 1 , 
3, 5, 4, 2 



6.3.8.7.4 Test Coverage 



CRR number 


Test case number 


CRRN1 


1, 2, 3, 4, 6, 8, 10, 12 


CRRN2 


5, 7, 9, 11 



6.3.9 File System Context 



6.3.9.1 Initial Context 

Test Area Reference: FWK_FSC_INIT. 

6.3.9.1.1 Conformance Requirements 

6.3.9.1.1.1 Normal Execution 

• CRRNl : At the invocation of the processToolkit method of a toolkit applet, the current file is the MF. 



6.3.9.1.1.2 

No requirements. 

6.3.9.1.1.3 

No requirements. 

6.3.9.1.2 
Test Script: 



Parameters errors 

Context errors 

Test Suite Files 

FWK FSC INIT l.scr 
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Test Applet: 

Load Script: 
Cleanup Script: 

Parameter File: 



FWK_FSC_INIT_1 Java 
FWK_FSC_INIT_2.java 
FWK_FSC_INIT_1 .Idr 
FWK_FSC_INIT_1 xlr 
FWK_FSC_INIT_2.clr 
FWK_FSC_lNlT_l.par 



6.3.9.1.3 



Test Procedure 



API/Framework Expectation 



Id 


1 



Description 



APDU Expectation 



SIM Initialization 



Responses ignored. 



No exception sliall be thrown. 
Sliall return 7. 

fci sliall contain tine following part of 

the FCI structure: 

< XX XX XX XX 3F 00 01 > 



lUlF is the selected DP in processToolkit() 

An ENVELOPE APDU containing a formatted 
SMS PP for Applet 1 is issued to the SIM 
byte[] fci = new byte [10] 
fciOffset = 
fciLength = 7 
status ( ) 



rehabilitate 



No EF is selected 





SllVIView exception shall be thrown 
with reason NO EF SELECTED 



MF is selected even when an applet triggered 
before selected any other file... 

Applets 1 and 2 register to 

EVENT_DOWNLOAD_USER_ACTIVITY. Applet 1 has 
higher priority than Applet 2. 



An ENVELOPE "EVENT 
sent to the SIM 



USER ACTIVITY" is 



1 - Applet 1: 

- is triggered by 

event_event_download_user_activity 

- selects DF_GSM and EF_IMSI 

2 - Applet 2 : 

- is triggered by 

event_event_download_user_activity 
fciOffset = 
fciLength = 7 
status ( ) 

3 - rehabilitate () 



1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

Shall return 7. 

fci shall contain the following part of 

the FCI structure: 

< XX XX XX XX 3F 00 01 > 

3 - SIMView exception shall be 
thrown with reason 

NO EF SELECTED 



6.3.9.1 .4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1, 2, 3 



6.3.9.2 Context Preservation (current file) 

Test Area Reference: FWK_FSC_CUFI. 

6.3.9.2.1 Conformance Requirements 

6.3.9.2. 1 . 1 Normal execution 

• CRRNl: When calling the method select (), the current files (file context) of any other applets shall not be 
changed (see GSM 03.19 [7], subclause 5.2). 

• CRRN2: The select() methods select a file without changing the current file of any other applet or of the 
subscriber session. 
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• CRRN3: After invocation of ProactiveHandler.send() method: the current file context of the toolkit applet is 
unchanged (see GSM 03.19 [7], subclause 5.2). 



6.3.9.2.1.2 

No requirements. 

6.3.9.2.1.3 

No requirements. 

6.3.9.2.2 

Test Script: 
Test Applet: 

Load Script: 
Cleanup Script: 

Parameter File: 
6.3.9.2.3 



Parameters errors 
Context errors 

Test Suite Files 

FWK_FSC_CUF1_1 .scr 
FWK_FSC_CUF1_1 .Java 
FWK_FSC_CUFl_2.j ava 
FWK_FSC_CUFI_l.ldr 
FWK_FSC_CUFI_l.ch 
FWK_FSC_CUFI_2.ch 
FWK_FSC_CUFI_1 .par 

Test Procedure 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



SIM Initialization 



Responses ignored. 



No change to file context by another applet 

Appletl registers to 
EVENT_FORMATTED_SMS_PP_ENV . 
Applet2 registers to 
EVENT_CALL_CONTROL_BY_SIM 

1 - Applet 1 : 

- is triggered by a formatted SMS 

- selects DF_SIMTEST and EF_TARU 

- fileOffset = 0; dataLength = 2; 
dataOffset = 0; 

- buffer = {OxCA, OxFE } 

- updateBinary () : first 2 bytes of 
EF_TARU are written as ' CA FE ' . 

- issues a proactive command "Get Inkey" . 

2 - An ENVELOPE APDU containing a CALL 
CONTROL BY SIM is issued to the SIM 

Applet 2 : 

- is triggered by a CALL CONTROL BY SIM 

- selects DF_TELECOM and EF_ADN. 

3 - The terminal response for Get Inkey 
reactivates Applet 1: 

- fileOffset = 0; respLength = 2; 
respOffset = 0; 

- readBinary () info buffer2 



1 - No exception sliall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 
The value of buffer2 is { OxCA, 
OxFE} 



A GET INKEY proactive 
command is fetched from 
the SIM 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


2 


No change to file context by subscriber 
session 

1 - Applet 1 

- issues a proactive command "Get Inkey". 

2 - Subscriber session selects DF_TELECOM 
and EF_ADN. 

3 - The terminal response for Get Inkey 
reactivates Applet 1 : 

- fileOffset = 0; respLength = 2; 
respOffset = 0; 

- readBlnary () info buffer2 


1 - No exception shall be thrown. 
3 - No exception shall be thrown. 
The value of buffer2 is { OxCA, 
OxFE} 


1 - A GET INKEY proactive 
command is fetched from 
the SIM 


3 


No change by applet of subscriber session 
context 

1 - Applet 1 : 

- selects DF_SIMTEST and EF_TNU 

- issues a proactive command "Get Inkey". 

2 - subscriber session reads record 1 of 
current file (shall be EF_ADN) 

3 - The terminal response for Get Inkey 
reactivates Applet 1, which terminates 
execution 


1 - No exception shall be thrown. 
3 - No exception shall be thrown. 


1 - A GET INKEY proactive 
command is fetched from 
the SIM 

2 - READ RECORD 
absolute number 1 shall 
read "FF FF FF FF FF FF 
FF FF FF FF FF FF FF FF 
FF FF FF FF FF FF FF FF 
FF FF FF FF FF FF" (from 
EFadn) 



6.3.9.2.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1 


GRRN2 


1, 2, 3 


CRRN3 


1,2 



6.3.9.3 Context Preservation (current record pointer) 

Test Area Reference: FWK_FSC_CURE. 

6.3.9.3.1 Conformance Requirements 

6.3.9.3.1.1 Normal execution 

• CRRNl : When the seek method is called by one applet, the record pointer of any other applet is not changed. 

• CRRN2: updateRecord: the current record pointer of other applets / subscriber shall not be changed in case of 
hnear fixed EF. 

• CRRN3: updateRecord: the record pointer of a cychc EF shall be changed for aU other applets / subscriber to the 
record number 1. 

• CRRN4: readRecord: read data bytes of the linear fixed or cyclic EF currently selected by the applet without 
changing the current record pointer of any other applet / subscriber. 

• CRRN5: increase: the last updated record of the cyclic EF currently selected becomes record number 1 for every 
other applet and subscriber session. 

6.3.9.3.1.2 Parameters errors 

No requirements. 
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6.3.9.3.1.3 

No requirements. 

6.3.9.3.2 

Test Script: 
Test Applet: 

Load Script: 
Cleanup Script: 

Parameter File: 



Context errors 

Test Suite Files 

FWK_FSC_CURE_1 .scr 
FWK_FSC_CURE_1 .java 
FWK_FSC_CURE_2.java 
FWK_FSC_CURE_1 .Idr 
FWK_FSC_CURE_1 .clr 
FWK_FSC_CURE_2.clr 
FWK_FSC_CURE_1 .par 



6.3.9.3.3 



Test Procedure 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



SIM Initialization 



Responses ignored. 



Seek without affecting another record pointer 

Appletl registers to 
EVENT_FORMATTED_SMS_PP_ENV 
Applet 2 registers to 
EVENT_CALL_CONTROL_BY_S IM 

1 - Applet 1 : 

- is triggered by a formatted SMS event 

- selects DF_SIMTEST and EF_LARU 

- reads record 2 using NEXT so that the 
current record pointer is set to record 2 

- issues a proactive command, e.g. Get 
Inkey . 

2 - An ENVELOPE APDU containing a CALL 
CONTROL BY SIM is issued to the SIM 

Applet 2: 

- is triggered by a CALL CONTROL event 

- selects DF_SIMTEST and EF_LARU 

- performs a seek of pattern {0x55} from 
beginning forward, which finds record 1. 

- returns from processToolkit 

3 - The terminal response for Get Inkey 
reactivates Applet 1: 

- call readRecordO using CURRENT 

- the record read should still be record 2 
of EF_LARU, containing { OxAA, OxAA, OxAA, 
OxAA} 



1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 



1 - A GET INKEY proactive 
command is fetched from 
the SIM 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


2 


updateRecord in linear fixed EF without 
affecting current pointer of others 

1 - Applet 1 : 

- is triggered by a formatted SMS event 

- selects DF_SIMTEST and EF_LARU 

- reads record 2 using NEXT so that the 
current record pointer is set to record 2 

- issues a proactive command, e.g. Get 
Inkey . 

2 - An ENVELOPE APDU containing a CALL 
CONTROL BY SIM is issued to the SIM 

Applet 2 : 

- is triggered by a CALL CONTROL BY SIM 
event 

- selects DF_SIMTEST and EF_LARU 

- updates record 1, by using mode "NEXT". 

- returns from processToolkit 

3 - The terminal response for Get Inkey 
reactivates Applet 1 : 

- call readRecordO using CURRENT 

- the record read should still be record 2 
of EF_LARU, containing { OxAA, OxAA, OxAA, 
OxAA} 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 


1 - A GET INKEY proactive 
command is fetched from 
the SIM 


3 


readRecord in linear fixed EF without affecting 
current pointer of others 

1 - Applet 1: 

- is triggered by a formatted SMS event 

- selects DF_SIMTEST and EF_LARU 

- reads record 2 using NEXT so that the 
current record pointer is set to record 2 

- issues a proactive command, e.g. Get 
Inkey . 

2 - An ENVELOPE APDU containing a CALL 
CONTROL BY SIM is issued to the SIM 

Applet 2 : 

- is triggered by a CALL CONTROL BY SIM 
event 

- selects DF_SIMTEST and EF_LARU 

- reads record 1, by using mode "NEXT". 

- returns from processToolkit 

3 - The terminal response for Get Inkey 
reactivates Applet 1: 

- call readRecordO using CURRENT 

- the record read should still be record 2 
of EF_LARU, containing {OxAA, OxAA, OxAA, 
OxAA} 


1 - No exception shall be thrown. 

2 - No exception shall be thrown. 

3 - No exception shall be thrown. 


1 - A GET INKEY proactive 
command is fetched from 
the SIM 



6.3.9.3.4 Test Coverage 



CRR Number 


Test Case Number 


CRRN1 


1 


GRRN2 


2 


CRRN3 


not tested (see note) 


CRRN4 


3 


CRRN5 


not tested (see note) 


NOTE: These requirements have not been tested because of 

an inconsistent behaviour in GSM 03.19 [7], which is 
foreseen to be corrected in future releases. 
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6.3.10 Other parts transferred to framework from API 
6.3.1 0.1 A handler is a temporary JCRE Entry Point object 

Test Area Reference: FWK_API_HEPO. 

6.3.10.1.1 Conformance Requirement 

6.3.10.1.1.1 Normal execution 

• CRRNl : The EnvelopeHandler is a Temporary JCRE Entry Point Object (see Javacard 2.1 Runtime 
Environment (JCRE) Specification [12]). 

• CRRN2: The EnvelopeResponseHandler is a Temporary JCRE Entry Point Object (see Javacard 2.1 Runtime 

Environment (JCRE) Specification [12]). 

• CRRN3: The ProactiveHandler is a Temporary JCRE Entry Point Object (see Javacard 2.1 Runtime 
Environment (JCRE) Specification [12]). 

• CRRN4: The ProactiveResponseHandler is a Temporary JCRE Entry Point Object (see Javacard 2. 1 Runtime 
Environment (JCRE) Specification [12]). 

6.3.1 0.1 .1 .2 Parameters errors 
No requirements. 

6.3.10.1.1.3 Context errors 

No requirements. 



6.3.10.1.2 Test suite files 



Test Script: 


FWK 


.API. 


.HEPO. 


.l.scr 


Test Applet: 


FWK 


.API. 


.HEPO. 


.l.java 


Load Script: 


FWK 


.API. 


.HEPO. 


.l.ldr 


Cleanup Script: 


FWK 


_API_ 


_HEPO_ 


_l.clr 


Parameter File: 


FWK 


_AP1_ 


_HEPO_ 


_1 .par 



6.3.1 0.1 .3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


EnvelopeHandler.getTheHandler and store it in 
a static field of the toolkit applet 


SecurityException is thrown 




2 


EnvelopeHandler.getTheHandler and store it in 
a field of the tooll<it applet 


Security Exception is thrown 




3 


EnvelopeResponseHandler.getTheHandler and 
store it in a static field of the toolkit applet 


SecurityException is thrown 




4 


EnvelopeResponseHandler.getTheHandler and 
store it in a field of the toolkit applet 


SecurityException is thrown 




5 


ProactiveHandler.getTheHandler and store it in 
a static field of the toolkit applet 


SecurityException is thrown 




6 


ProactiveHandler.getTheHandler and store it in 
a field of the toolkit applet 


SecurityException is thrown 




7 


Build and send a DISPLAY TEXT command to 
be able to get the reference of the 
ProactiveReponseHandler 

ProactiveResponseHandler.getTheHandler and 
store it in a static field of the toolkit applet 


SecurityException is thrown 


Proactive command fetched 
and terminal response is 
issued 
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Id 


Description 


API/Framework Expectation 


APDU Expectation 


8 


ProactiveResponseHandler.getTlieHandler and 
store it in a field of the toolkit applet 


SecurityException is thrown 





6.3.1 0.1 .4 Test Coverage 



CRR number 


Test case number 


N1 


1,2 


N2 


3,4 


N3 


5, 6 


N4 


7, 8 



6.3.10.2 Transaction 

Test Area Reference: FWK_API_TRAN. 

6.3.10.2.1 Conformance Requirement 

6.3.10.2.1.1 Normal execution 

• CRRNl : A pending toolkit applet transaction at the ProactiveHandler.send() method invocation is aborted. 



6.3.10.2.1.2 
No requirements. 

6.3.10.2.1.3 

No requirements. 

6.3.10.2.2 

Test Script: 
Test Applet: 
Load Script: 
Cleanup Script: 
Parameter File: 

6.3.10.2.3 



Parameters errors 
Context errors 
Test suite files 

FWK_API_TRAN_1 .scr 
FWK_API_TRAN_1 .Java 
FWK_API_TRAN_1 .Idr 

FWK_AP1_TRAN_1 .ch 
FWK_API_TRAN_1 .par 

Test Procedure 



Id 



Description 



API/Framework Expectation 



APDU Expectation 



Verify that transaction is aborted when a 
proactive command is sent 

Initialize a byte field with 0x05 
Build a display text proactive command. 
beginTransaction () 
Update the byte with 0x02 
send the proactive command 



Verify that the byte value is 0x05 
JCSystem. getXransactionDepth ( ) 



Proactive command fetched 
and terminal response is 
issued 



Shall return 
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6.3.10.2.4 Test Coverage 



CRR number 


Test case number 


N1 


1 



6.3.1 0.3 Timer Id between Applets 

Test Area Reference: FWK_API_TMID. 

6.3.10.3.1 Conformance Requirement 

6.3.10.3.1.1 Normal execution 

No requirements. 

6.3.1 0.3.1 .2 Parameters errors 
No requirements. 

6.3.10.3.1.3 Context errors 

• CRRCl: The method ToolkitRegistry.releaseTimer() shall throw a ToolkitException with 
INrVALID_TIMER_ID reason if the timer is valid but isn't allocated to this applet. 

6.3.10.3.2 Test suite files 



Test Script: 


FWK_ 


_AP1_ 


_TM1D_ 


_l.scr 


Test Applet: 


FWK 


.API. 


.TMID. 


.l.java 


Load Script: 


FWK 


.API. 


TMID. 


.l.ldr 


Cleanup Script: 


FWK 


.API. 


TMID. 


.l.ch 


Parameter File: 


FWK 


.API. 


TMID. 


.l.par 



6.3.10.3.3 Test Procedure 



Id 


Description 


API/Framework Expectation 


APDU Expectation 


1 


During Installation : 
First instance allocate a timer and store the 
returned value in a static field. 
Second instance allocate a timer. 
Trig second instance and try to releaseTimer() 
with the static field value. 


releaseTimerO shall throw a 

ToolkitException with 
INVALID TIMER ID reason 





6.3.10.3.4 Test Coverage 



CRR number 


Test case number 


N1 


1 
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Annex A (normative): 

Class and Methods AID numbering and acronyms 
A.1 Sim. access 



Class Name 


Acronyms 


Numbering on 5 bits 


SIMView 


svw 


00001 


SIMSystem 


SSY 


00010 


SIMViewException 


SVE 


00011 



A.1.1 SIMView methods 



Method Name 


Acronyms 


Numbering on 6 bits 


static final Constants 




000001 


short increase (byte [ ] incr, short incrOffset, byte[] resp, 
short respOffset) 


INCR_BS_BS 


000010 


void invalidate 


INVL 


000011 


void readBinary ( short fileOffset, byte [ ] resp, short 
respOffset, short respLength) 


REDBS_BSS 


000100 


short readRecord ( short recNumber, byte mode, short recOffset, 
byte [ ] resp, short respOffset, short respLength) 


REDRSBS_BSS 


000101 


void rehabilitate!) 


REHA 


000110 


short seek (byte mode, byte [ ] patt, short pattOffset, short 
pattLength) 


SEEKB_BSS 


000111 


void select (short fid) 


SLOTS 


001000 


short select (short fid, byte[] fci, short fciOffset, short 
f ciLength) 


SLCTS_BSS 


001001 


short status (byte [ ] fci, short fciOffset, short f ciLength) 


STAT BSS 


001010 


short updateBinary (short fileOffset, byte [ ] data, short 
dataOffset, short dataLength) 


UPDBS_BSS 


001011 


void updateRecord ( short recNumber, byte mode, short recOffset, 
byte [ ] data, short dataOffset, short dataLength) 


UPDRSBS_BSS 


001100 



A.1 .2 SllVISystenn methods 



Method Name 


Acronyms 


Numbering on 6 bits 


static SIMView getXheSIMView ( ) 


GETS 


000001 



A.1. 3 SIIVIViewException methods 



Method Name 


Acronyms 


Numbering on 6 bits 


static void throwit ( short reason) 


THITS 


000001 


SIMViewException (short reason) 


COORS 


000010 


Constants 


CONS 


000011 
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A.2 Sim.toolkit 



Class Name 


Acronyms 


Numbering on 5 bits 


Toolkit Constants 


TKC 


00001 


Toolk.it Intsirfa.cs 


1 M 


0001 


EditHandler 


EDH 


00011 


Envelope Handler 


ENH 


00100 


EnvelopeResponseHandler 


ERH 


00101 


MEProf lie 


MEP 


00110 


Proactive Handler 


PAH 


00111 


Proact IveResponseHandler 


PRH 


01000 


ToolkitRegistry 


TKR 


01001 


ViewHandler 


VWH 


01010 


Toolkit Except ion 


TKE 


01011 



A.2.1 ToolkitConstants 



Method Name 


Acronyms 


Numbering on 6 bits 


Constants 


CONS 


000001 



A.2. 2 Toolkitlnterface methods 



Method Name 


Acronyms 


Numbering on 6 bits 


void processToolkit (byte event) 


PRTKB 


000001 



A.2.3 EditHandler methods 

The numbering of the EditHandler methods it will be done in the classes inherit it: EnvelopeResponseHandler, 
ProactiveHandler, because the methods provided by this class as it is declared 'abstract'. 



A.2. 4 EnvelopeHandler methods 



Method Name 


Acronyms 


Numbering on 6 bits 


byte getEnvelopeTag ( ) 


GENT 


000001 


byte getltemldentif ier ( ) 


GIID 


000010 


short getSecuredDataLength ( ) 


GSDL 


000011 


short getSecuredDataOf f set ( ) 


GSDO 


000100 


EnvelopeHandler getTheHandler ( ) 


GTHD 


000101 


short getTPUDLOf f set 


GTPO 


000110 








Inherited Method Name: ViewHandler 






Byte 

compareValue ( short valueOff set, byte [ ] compareBuf fer, s 
hort compareOf f set, short compareLength) 


CPRVS_BSS 


000111 


Short 

copy (byte [] dstBuf fer, short dstOff set , short dstLength 
) 


GOPY_BSS 


001000 


Short 

copyValue (short valueOff set, 

byte[] dstBuf fer, short dstOff set , short dstLength) 


GPYVS_BSS 


001001 


Byte 

f indAndCompareValue (byte tag, byte [] compareBuf fer, sho 
rt compareOf f set) 


FACRB_BS 


001010 


Byte f indAndCompareValue (byte tag, byte occurence, 
short valueOff set , byte [ ] compareBuf fer, short compareO 
ff set, short compareLength) 


FAGRBBS_BSS 


001011 
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Metnou Name 


Acronyms 


Numbering on 6 bits 


Short 

FindAndCopyValue (byte tag, byte occurence, short valueO 
ffset, byte[] dstBuffer, short dstOffset, 

short dstLength) 


FACYBBS_BSS 


001100 


Short 

f indAndCopyValue (byte tag, byte [] dstBuffer, short dstO 
ffset) 


FACYB_BS 


001101 


Byte 

FindTLV(byte tag, byte occurrence) 


FINDBB 


001 110 


Short 

GetLength ( ) 


GLEN 


001111 


Byte 

GetValueByte ( short valueOffset) 


GVBYS 


010000 


Short 
GetValueLength ( ) 


GVLE 


010001 


A.2.5 EnvelopeResponseHandler methods 


Method Name 


Acronym 


Numbering on 6 bits 


EnvelopeResponseHandler getTheHandler () 


GTHD 


000001 


Void post (byte statusType) 


POSTB 


000010 


Void postAsBERTLV (byte StatusType, byte tag) 


POSTBB 


000011 








Inherited Method Name: EditHandler 






Void appendArray (byte [ ] buffer, short offset, short 
length, short dstLength) 


APDA_BSS 


000100 


Void appendTLV (byte tag, byte value) 


APTI RR 


UUU 1 \J 1 


Void appendTLV (byte tag, byte[] value, short 
valueOffset, short valueLength) 


APTLB_BSS 


000110 


Void appendTLV (byte tag, byte valuel, byte value2) 


Ar 1 Lddd 


0001 1 1 


Void appendTLV (byte tag, byte valuel, byte [ ] value2, 
short value20f f set, short value2Length) 


APTLBB_BSS 


001000 


Void clear ( ) 


GLER 


001001 








Inherited Method Name: ViewHandler 






Byte 

compareValue (short valueOffset, byte [ ] compareBuf fer, s 
hort compareOf f set, short compareLength) 


CPRVS_BSS 


001010 


Short 

Copy (byte [ ] dstBuffer, short dstOff set , short dstLength 
) 


COPY_BSS 


001011 


Short 

CopyValue ( short valueOffset, 

byte [ ] dstBuffer, short dstOff set , short dstLength) 


CPYVS_BSS 


001100 


Byte 

FindAndCompareValue (byte tag, byte [] compareBuf fer, sho 
rt compareOf f set) 


FACRB_BS 


001101 


Byte f indAndCompareValue (byte tag, byte occurence, 
short valueOffset, byte [ ] compareBuf fer, short compareO 
ffset, short compareLength) 


FAGRBBS_BSS 


001110 


Short 

FindAndCopyValue (byte tag, byte occurence, short valueO 
ffset, byte[] dstBuffer, short dstOffset, 
short dstLength) 


FACYBBS_BSS 


001111 


Short 

f IndAndCopyValue (byte tag, byte [] dstBuffer, short dstO 
ffset) 


FAGYB_BS 


010000 


Byte 

FindTLV(byte tag, byte occurrence) 


FINDBB 


010001 


Short 

GetLength 


GLEN 


010010 


Byte 

GetValueByte ( short valueOffset) 


GVBYS 


010011 


Short 
GetValueLength ( ) 


GVLE 


010100 
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Method Name 


Acronym 


Numbering on 6 bits 


static boolean check (byte index) 


CHECB 


000001 


static boolean check (byte [] mask, short offset, short 
length) 


CHECBSS 


000010 


static boolean check (short index) 


CHECS 


000011 


static short copy (short startOffset, 

byte[] dstBuffer, short dstOffset, short dstLength) 


COPYS_BSS 


000100 


static short getValue ( short indexMSB, short indexLSB) 


GVALSS 


000101 



A.2.7 ProactiveHandler methods 



Method Name 


Acronyms 


Numbering on 6 bits 


GetTheHandler ( ) 


GTHD 


000001 


Init (byte type, byte qualifier, byte dstDevice) 


INITBBB 


000010 


InitDisplayText (byte qualifier, byte dcs, byte[] 
buffer, short offset, short length) 


INDTBB_BSS 


00001 1 


InitGetlnkey (byte qualifier, byte dcs, byte[] buffer, 
short offset, short length) 


INGKBB_BSS 


000100 


InitGetlnput (byte qualifier, byte dcs, byte[] buffer, 
short offset, short length, short minRespLength, short 
maxRespLength) 


INGPBB_BSSSS 


000101 


Byte sendO 


SEND 


000110 








inneritea n/ietnoa Name: baitnanoier 






Void appendArray (byte [ ] buffer, short offset, short 
length, short dstLength) 


APDA_BSS 


0001 1 1 


Void appendTLV (byte tag, byte value) 


APTLBB 


001000 


Void appendTLV (byte tag, byte[] value, short 
valueOffset, short valueLength) 


APTLB_BSS 


001001 


Void appendTLV (byte tag, byte valuel, byte value2) 


APTLBBB 


001010 


Void appendTLV (byte tag, byte valuel, byte[] value2, 
short value20f f set , short value2Length) 


APTLBB_BSS 


001011 


Void clear ( ) 


GLER 


001100 








inneriieQ ivieinou Name, viewnanaier 






Byte 

CompareValue ( short valueOff set , byte [ ] compareBuf fer, sh 
ort compareOf f set , short compareLength) 


GPRVS_BSS 


001101 


Short 

Copy (byte [] dstBuffer, short dstOff set , short dstLength) 


COPYBSS 


001 110 


onor c 

CopyValue ( short valueOffset, 

byte[] dstBuffer, short dstOff set , short dstLength) 


YVbbbo 


UUl 111 


Byte 

FindAndCompareValue (byte tag, byte [] compareBuf fer, shor 
t compareOf f set ) 


FAGRB_BS 


010000 


Byte f indAndCompareValue (byte tag, byte occurence, 
short valueOff set , byte [ ] compareBuf fer, short compareOf 
fset, short compareLength) 


FACRBBS_BSS 


010001 


Short 

FindAndCopyValue (byte tag, byte occurence, short valueOf 
fset, byte[] dstBuffer, short dstOffset, 
short dstLength) 


FACYBBS_BSS 


010010 


Short 

f indAndCopyValue (byte tag, byte [] dstBuffer, short dstOf 
fset) 


FAGYB_BS 


010011 


Byte 

FindTLV(byte tag, byte occurrence) 


FINDBB 


010100 


Short 

GetLength 


GLEN 


010101 


Byte 

GetValueByte ( short valueOffset) 


GVBYS 


010110 


Short 
GetValueLength ( ) 


GVLE 


010111 
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A.2.8 ProactiveResponseHandler methods 



Method Name 


Acronyms 


Numbering on 6 bits 


Short CopyAdditionalInf ormation (byte [ ] dstBuf f er. 


CPAIBSS 


000001 


Short copyTextString (byte [ ] dstBuf fer, short 
dstOffset) 


CRTS BS 


000010 


Short getAdditionalInf ormationLength ( ) 


GTIL 


000011 






UUU1 UU 


Byte getltemldentif ier ( ) 


GTII 


000101 


Byte getTextStringCodingScheme ( ) 


GTCS 


000110 


Short getTextStringLength ( ) 


GTTL 


000111 


GetTheHandler 


GTHD 


001000 








Inherited Method Name: ViewHandler 






Byte 

CompareValue ( short valueOff set , byte [ ] compareBuf fer, s 
hort compareOf f set , short compareLength) 


GPRVS_BSS 


001001 


Short 

Copy (byte [] dstBuf fer, short dstOff set , short dstLength 
) 


GOPY_BSS 


001010 


Short 

CopyValue ( short valueOffset, 

byte[] dstBuf fer, short dstOff set , short dstLength) 


CPYVS_BSS 


001011 


Byte 

FindAndCompareValue (byte tag, byte [] compareBuf fer, sho 
rt compareOf f set ) 


FACRB_BS 


001100 


Byte f indAndCompareValue (byte tag, byte occurence, 
short valueOff set , byte [ ] compareBuf fer, short compareO 
ffset, short compareLength) 


FACRBBS_BSS 


001101 


Short 

FindAndCopyValue (byte tag, byte occurence, short valueO 
ffset, byte[] dstBuf fer, short dstOffset, 
short dstLength) 


FACYBBS_BSS 


001110 


OIlOJl C 

f indAndCopyValue (byte tag, byte [] dstBuf fer, short dstO 
ffset) 


rAOYBBo 


UUl 111 


Byte 

FindTLV(byte tag, byte occurrence) 


FINDBB 


010000 


Short 

GetLength 


GLEN 


010001 


Byte 

GetValueByte ( short valueOffset) 


GVBYS 


010010 


Short 
GetValueLength ( ) 


GVLE 


010011 
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A.2.9 ToolkitRegistry methods 



Method Name 


Acronyms 


Numbering on 6 bits 


AllocateTimer ( ) 


ATIM 


000001 


changeMenuEntry (byte id, byte[] menuEntry, short 


CMETB_BSSBZBS 


000010 


offset, short length, byte nextAction, boolean 






helpSupported, byte IconQualif ier, short 






icon Identifier) 








OtV 1 D 


UUUUl \ 


LA _L O CL -L C: i i c:ilUI_jilLJ_y ^ l-J y L- c: _L LJ. / 


UMt 1 D 


UUUl UU 


e nab 1 eMe nuE nt r y (byte id) 


tlVIt 1 D 


UUUl U1 


getEnt ry ( ) 


GETY 


AAA H H A 

000110 


getPollInterval () 


GPOL 


000111 


initMenuEntry (byte [ ] menuEntry, short offset, short 


IMET_BSSBZBS 


001000 


length, byte nextAction, boolean helpSupported, byte 






IconQualif ier , short iconldentif ier ) 






isEventSet (byte event) 


lEVSB 


001001 


releaseTimer (byte timerldentif ier ) 


RTIM 


001010 


requestPollInterval (short duration) 


RPOL 


001011 


setEvent (byte event) 


SEVTB 


001100 


setEventList (byte [ ] eventList, short offset, short 


SEVL BSS 


001101 


length) 







A.2.10 ViewHandler methods 

The numbering of the ViewHandler methods it will be done in the classes inherit it: EditHandler, EnvelopeHandler, 
ProactiveResponseHandler, ProactiveHandler, because the methods provided by this class as it is declared 'abstract'. 



A.2.11 ToolkitException methods 



IVIethod Name 


Acronyms 


Numbering on 6 bits 


static void throwit (short reason) 


THUS 


000001 


ToolkitException (short reason) 


GOORS 


000010 


Constants 


CONS 


000011 
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Annex B (normative): 

Script file syntax and format description 

B. 1 Syntax description 

Following is a syntax description in BNF. 

<statement list> ::= [ <statement> \n] + 

<statement> ::= <simple> I <switch> I <blank line> 

<simple> ::= <reset> I <init> I <conimand> I <remark> 

<reset> ::= RST 

<init> ::= INI <hexdata> 

<conimand> ::= CMD <hexdata> [ <response> ] ( <status> ) 

<response> ::= [ <hexdata> ] 

<status>::= (<hexdata>) 

<remark> ::= REM <text lino 

<switch> ::= SWI { [<labelled list>] + } 

<labelledlist> ::= <label> : \n <statement list> 

Description of syntax metalanguage: 

\n represents a linebreak 

[ X ] means x can appear optionally 

[ X J + means 1 or more appearances of x 

X I y means x or y 

[ ] { } : (bold) these are characters that appear literally in the script files 

<text lino any character until the end of the line 
<blank lino a line containing no text is acceptable 

<hexdata> data written in hexadecimal, each byte separated from the following by a whitespace 

Each simple statement beginning with 3 characters different than the ones defined indicates another tool command, and 
shall be ignored by the parser if not recognized. 

' ' , ' \ t ' : Can be used as separator 

A long statement can be broken into several hnes by using the character '\' at the end of each line which is not the last 

one in the statement. 

For more details refer to the examples in clause B.3. 



ETSI 



3GPP TS 11.13 version 8.2.1 Release 1999 



407 



ETSI TS 101 955 V8.2.1 (2003-04) 



B.2 Semantics 

Following is the meaning of each of the statements: 

CMD: Sends an APDU Command to the card, including (optionally) the expected response data and 

also (optionally) the expected status words SWl, SW2 . 
RST: Resets and powers on the card 

INI: Performs the terminal profile with the following data. Afterwards, it shall perform all the 

fetch and terminal response commands until there is no proactive session in progress. 
REM: Used for comments 

SWI : Activates a switch condition. Every labelled list represents a list of statements to be 
executed, if the label matches the SW resulting from the previously executed command. 



Evaluation of expected response and status in the case of a CMD: 

<response> data within [...] has to be checked, it needs to be present for an outgoing command. Bytes 

written as XX shall not be checked by the APDU tool . 
<status> status contained within (...) has to be checked; when several status are valid they shall 

be separated by commas. Nibble written as X shall not be checked by the APDU tool. 



B.3 Example 

REM this is an example: 



RST 

INI FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF FF 
REM Case 1 example 

CMD AO C2 00 00 00 (91 33 , 69 XX) 

REM Case 2 example 
CMD AO B6 00 00 07 \ 

[XX XX XX 55 55 XX 55] \ 

(91 33 , 67 XX) 



CMD AO B6 00 00 07 \ 
(91 33 , 67 XX) 



CMD AO CO 00 00 IF \ 

[10 AO 00 00 00 09 00 02 FF FF FF FF 89 28 A4 05 \ 
02 OD CC CC CC CC CC CC CC CC CC CC CC CC CC ] \ 
(90 00) 



REM Case 3 example 

CMD AO C2 00 00 33 \ 

Dl 31 82 02 83 81 06 05 80 11 22 33 44 8B 24 40 \ 
08 00 24 23 85 18 41 04 51 10 10 00 00 00 00 13 \ 
02 70 00 00 OE OD 00 00 00 00 28 A4 05 00 00 00 \ 
00 00 00 \ 
(90 00) 

REM Case 4 example with switch statement 
CMD 00 A4 04 00 10 \ 

AO 00 00 00 09 00 02 FF FF FF FF 89 41 04 44 02 \ 
(61 XX, 6A 82) 

SWI { 
61 XX: 

CMD 00 CO 00 00 14 \ 

[10 AO 00 00 00 09 00 02 FF FF FF FF 89 41 04 44 \ 
02 02 CC CC] \ 
(90 00) 



CMD AO A4 00 00 02 \ 
3F 00 



6A 82: 
RST 



ETSI 



3GPP TS 11.13 version 8.2.1 Release 1999 



408 



ETSI TS 101 955 V8.2.1 (2003-04) 



REM Case 5 example 

CMD AO C2 00 00 33 \ 

Dl 31 82 02 83 81 06 05 80 11 22 33 44 8B 24 40 \ 
08 00 24 23 85 18 41 04 51 10 10 00 00 00 00 13 \ 
02 70 00 00 OE OD 00 00 00 00 28 A4 05 00 00 00 \ 
00 00 00 \ 
(6X 00) 



B.4 Style and formatting 

In order to show a common appearance all the scripts shall follow those format rules: 

• Start always with a 'RST' followed by an 'INI' command. 

• The command, data to be checked and status to be checked shall be presented in the following order: 
- CMD COMMAND [EXPECTED DATA] (EXPECTED STATUS). 

• APDU shall be presented with command (CLA INS PI P2 P3) in one line and data (if present) in next line 
grouped 16 bytes per line (see example above). 

• The expected data (if present) shall be presented in 16 bytes groups per line (see example above). 
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Annex C (normative): 
Default Prepersonalization 



C.1 General Default Prepersonalization 

This table shows the defauh prepersonalization, the file system and the files' content, that the test SIM cards shall 
contain unless otherwise stated. 



Name 


Identifier 


Default Value 


Snecial Features 


triCCiD 




OF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 






This value is not compliant with GSM 11.11 [3] 


EFiMSi 


6F07 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 








This value is not compliant with GSM 11.11 [3] 


EFlp 


6F05 


01 


FF 


FF 


FF 




















EFkc 


6F20 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


07 










EFpi mnqpi 


6F30 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 








FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 




EFhpi mm 


6F31 


05 




EFACMmax 


oro / 


00 


00 


00 






















EFsST 


onoo 


FF 


3F 


C3 


OF 


OC 


00 


FF 


OF 


00 


33 








tl-ACM 


Droy 


00 


00 


00 




















Access conaiTion ur ua i t. on vi 


EFpucT 


6F41 


FF 


FF 


FF 


00 


00 
















Access condition UPDATE: CHV1 


EFbcch 


6F74 


FF 
FF 


FF 
FF 


FF 
FF 


FF 
FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 




EFacc 


6F78 


00 


00 
























EFfplmn 


6F7B 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 




EFloci 


6F7E 


FF 


FF 


FF 


FF 


00 


FO 


00 


00 


00 


FF 


01 






CrAD 


RFAD 


00 


FF 


FF 






















EFphase 


6FAE 


03 




EFfdn 


6F3B 


Default value 


in all 


the records 




Records: 5 






FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 








FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 








FF 


FF 


FF 


FF 




















EFsMSP 


6F42 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


Records: 1 






FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 








FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 








FF 


FF 


FF 


FF 


FF 


FF 
















EFlnd 


6F44 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


Records: 1 






FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 








FF 


FF 


FF 


FF 




















EFsMss 


6F43 


FF 


FF 
























EFsMS 


6F3C 




record : 


00 


FF 


.. FF (length 


176) 


Records: 3 






2nd 


record: 00 FF ... 


FF (length 176) 










3rd 


record : 


00 


FF 


.. FF (length 


176 






EFadn 


6F3A 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


Records: 1 






FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 








FF 


FF 


FF 


FF 




















EFccp 


6F3D 


FF 
FF 


FF 
FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 




EFmsisdn 


6F40 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


Records: 1 






FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 








FF 


FF 


FF 


FF 




















EFsDN 


6F49 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


Records: 1 






FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 








FF 


FF 


FF 


FF 




















EFsUME 


6F54 


85 
53 


OC 
54 


54 
FF 


4F 
FF 


4F 
FF 


4C 
FF 


4B 


49 


54 


20 


54 


45 




EFcBMI 


6F45 


FF 


FF 
























EFcBMID 


6F48 


10 


80 
























EFcBMIR 


6F50 


10 


80 


10 


9F 




















EFiM 


4F20 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 


FF 







The default value for the CHVl shall be "0x31 0x31 0x31 0x31 OxFF OxFF OxFF OxFF" and its state shall be 'disabled' 
during test applets execution. 
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C.2 Sim.Access.SimView test default prepersonalization 
C.2.1 DFsiMTEST (SIM Test) 

Identifier: '0319'. 

C.2. 2 EFtnr (Transparent Never Read) 





Identifier: '6F01' 


1 Structure: transparent 


Mandatory 




File size: 3 bytes 


1 Update activity: low 




Access Conditions: 
READ NEVER 
UPDATE ALWAYS 
INVALIDATE ALWAYS 
REHABILITATE ALWAYS 


Bytes 


Description 


Default Value 


M/0 


Length 


1 -3 


Test Data 


AA AA AA 


M 


3 bytes 



C.2. 3 EFtnu (Transparent Never Update) 





Identifier: '6F02' 


1 Structure: transparent 


Mandatory 




File size: 3 bytes 


1 Update activity: low 








Access Conditions: 








READ 


ALWAYS 








UPDATE NEVER 








INVALIDATE ALWAYS 








REHABILITATE ALWAYS 






Bytes 


Description 


Default Value 


M/0 


Length 


1 -3 


Test Data 


55 55 55 


M 


3 bytes 



C.2. 4 EFjARu (Transparent Always Read and Update) 





Identifier: '6F03' 


1 Structure: transparent 


Mandatory 




File size: 260 bytes 


1 Update activity: low 








Access Conditions: 








READ 


ALWAYS 








UPDATE ALWAYS 








INVALIDATE ALWAYS 








REHABILITATE ALWAYS 






Bytes 


Description 


Default Value 


M/0 


Length 


1 -260 


Test Data 


FF ... FF 


M 


260 bytes 
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Identifier: •6F04' | 


Structure: cyclic 




Mandatory 


Record length: 3 bytes 


1 Update activity: high 




Access Conditions: 








READ 


NEVER 








UPDATE 


ALWAYS 






INCREASE 


ALWAYS 






INVALIDATE 


ALWAYS 






REHABILITATE ALWAYS 




Logical 


Description 


Default Value 


M/0 


Length 


Record 










Number 










1 


Test Data 


00 00 00 


M 


3 bytes 


2 


Test Data 


00 00 00 


M 


3 bytes 



C.2.6 EFcNu (Cyclic Never Update) 



Identifier: 'GFOS' | 


Structure: cyclic 




Mandatory 


Record length: 3 bytes 


1 Update activity: high 




Access Conditions: 








READ 


ALWAYS 






UPDATE 


NEVER 








INCREASE 


NEVER 








INVALIDATE 


ALWAYS 






REHABILITATE ALWAYS 




Logical 


Description 


Default Value 


M/0 


Length 


Record 










Number 










1 


Test Data 


00 00 00 


M 


3 bytes 


2 


Test Data 


00 00 00 


M 


3 bytes 



C.2.7 EFcNic (Cyclic Never Increase) 



Identifier: '6F06 | 


Structure: cyclic 




Mandatory 


Record length: 3 bytes 


1 Update activity: high 




Access Conditions: 








READ 


ALWAYS 






UPDATE 


ALWAYS 






INCREASE 


NEVER 








INVALIDATE 


ALWAYS 






REHABILITATE ALWAYS 




Logical 


Description 


Default Value 


M/0 


Length 


Record 










Number 










1 


Test Data 


00 00 00 


M 


3 bytes 


2 


Test Data 


00 00 00 


M 


3 bytes 
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Identifier: '6F07 | 


Structure: cyclic 




Mandatory 


Record length: 3 bytes 


1 Update activity: high 




Access Conditions: 








READ 


ALWAYS 






UPDATE 


ALWAYS 






INCREASE 


ALWAYS 






INVALIDATE 


NEVER 








REHABILITATE ALWAYS 




Logical 


Description 


Default Value 


M/0 


Length 


Record 










Number 










1 


Test Data 


00 00 00 


M 


3 bytes 


2 


Test Data 


00 00 00 


M 


3 bytes 



C.2.9 EFcNRH (Cyclic Never Rehabilitate) 



Identifier: 'GFOS' 


Structure: cyclic 


Mandatory 


Record length: 3 bytes 




1 Update activity: high 






Access Conditions: 








READ 




ALWAYS 






UPDATE 


ALWAYS 






INCREASE 


ALWAYS 






INVALIDATE 


ALWAYS 






REHABILITATE NEVER 






Logical 


Description 




Default Value 


M/0 


Length 


Record 












Number 












1 


Test Data 


00 00 00 


M 


3 bytes 


2 


Test Data 


00 00 00 


M 


3 bytes 



C.2.10 EFcARu (Cyclic Always Read and Update) 



Identifier: '6F09' | 


Structure: cyclic 




Mandatory 


Record length: 3 bytes 


1 Update activity: high 




Access Conditions: 








READ 


ALWAYS 






UPDATE 


ALWAYS 






INCREASE 


ALWAYS 






INVALIDATE 


ALWAYS 






REHABILITATE ALWAYS 




Logical 


Description 


Default Value 


M/0 


Length 


Record 










Number 










1 


Test Data 


55 55 55 


M 


3 bytes 


2 


Test Data 


AAAAAA 


M 


3 bytes 
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Identifier: '6F0A' | 


Structure: linear fixed | 


Mandatory 




Record lengtli: 4 bytes 


1 Update activity: low 






Access Conditions: 








READ 


NEVER 








UPDATE 


ALWAYS 








INVALIDATE 


ALWAYS 








REHABILITATE ALWAYS 






Logical 


Description 


Default Value 


M/0 


Length 


Record 










Number 










1 


Test Data - Record 1 


FF FF FF FF 


M 


4 bytes 


2 


Test Data - Record 2 


FF FF FF FF 


M 


4 bytes 



C.2.1 2 EFlnu (Linear Fixed Never Update) 





Identifier: '6F0B' | 


Structure: linear fixed | 


Mandatory 


Record length: 4 bytes 


Update activity: low 




Access Conditions: 








READ 




ALWAYS 








UPDATE 




NEVER 








INVALIDATE 




ALWAYS 








REHABILITATE 


ALWAYS 






Logical 


Description 




Default Value 


M/0 


Length 


Record 












Number 












1 


Test Data - Record 1 


FF FF FF FF 


M 


4 bytes 


2 


Test Data - Record 2 


FF FF FF FF 


M 


4 bytes 



C.2.1 3 EFlaru (Linear Fixed Always Read and Update) 





Identifier: '6F0G' | 


Structure: linear fixed | 


Mandatory 




Record length: 4 bytes 


1 Update activity: low 






Access Conditions: 








READ 


ALWAYS 








UPDATE 


ALWAYS 








INVALIDATE 


ALWAYS 








REHABILITATE ALWAYS 






Logical 


Description 


Default Value 


M/0 


Length 


Record 










Number 










1 


Test Data - Record 1 


55 55 55 55 


M 


4 bytes 


2 


Test Data - Record 2 


AA AA AA AA 


M 


4 bytes 
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C.2.14 EFcNA (Cyclic Increase Not Allowed) 



Identifier: '6F0D' 



Structure: cyclic 



Mandatory 



Record length: 3 bytes 



Update activity: high 



Access Conditions: 
READ ALWAYS 
UPDATE ALWAYS 
INCREASE ALWAYS (see note 1 ) 

INVALIDATE ALWAYS 
REHABILITATE ALWAYS 



Logical Record 
Number 


Description 


Default Value 


M/0 


Length 


1 


Test Data 


00 00 00 


M 


3 bytes 


2 


Test Data 


00 00 00 


M 


3 bytes 



NOTE: This file will be personalized in a way such that increase is not allowed, as indicated by the 
FCI byte 8, bit 7 (GSM 11.11 [4]: FCI structure of an EF returned by the SELECT command) 



C.2.15 EFjRAc (Transparent Read Access Condition CHV2) 



Identifier: '6F0E' 




Structure: transparent | 


Mandatory 


Record length: 3 bytes 




1 Update activity: low 






Access Conditions: 








READ 




CHV2 








UPDATE 




ALWAYS 








INCREASE 


ALWAYS 








INVALIDATE 


ALWAYS 








REHABILITATE 


ALWAYS 






Logical Record 


Description 




Default Value 


M/0 


Length 


Number 












1 


Test Data 


00 00 00 


M 


3 bytes 



C.2.1 6 EFtiac (Transparent Invalidate Access Condition CHV1 ) 



Identifier: '6F0F' | 


Structure: transparent | 


Mandatory 


Record length: 3 bytes 


Update activity: low 




Access Conditions: 








READ 




ALWAYS 








UPDATE 




ALWAYS 








INCREASE 




ALWAYS 








INVALIDATE 




CHV1 








REHABILITATE 




ALWAYS 






Logical Record 


Description 




Default Value 


M/0 


Length 


Number 












1 


Test Data 


00 00 00 


M 


3 bytes 
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C.2.17 EFcAc (Cyclic Increase Access Condition CHV2) 



Identifier: '6F10' | 


Structure: cyclic | 


Mandatory 


Record length: 3 bytes 


Update activity: low 




Access Conditions: 








READ 




ALWAYS 








UPDATE 




ALWAYS 








INCREASE 




CHV2 








INVALIDATE 




ALWAYS 








REHABILITATE 




ALWAYS 






Logical Record 


Description 




Default Value 


M/0 


Length 


Number 












1 


Test Data 


00 00 00 


M 


3 bytes 


2 


Test Data 


00 00 00 


M 


3 bytes 



C.2.1 8 EFcAA (Cyclic Increase Access Condition ADM) 



Identifier: '6F11' | 


Structure: cyclic | 


Mandatory 


Record length: 3 bytes 


Update activity: low 




Access Conditions: 








READ 




ALWAYS 








UPDATE 




ALWAYS 








INCREASE 




ADM 








INVALIDATE 




ALWAYS 








REHABILITATE 




ALWAYS 






Logical Record 


Description 




Default Value 


M/0 


Length 


Number 












1 


Test Data 


00 00 00 


M 


3 bytes 


2 


Test Data 


00 00 00 


M 


3 bytes 



C.2.1 9 EFcNR, (Cyclic Never Rehabilitate Invalidated) 



Identifier: '6F1 2' | 


Structure: cyclic | 


Mandatory 


Record length: 3 bytes 


1 Update activity: low 






Access Conditions: 








READ 


ALWAYS 








UPDATE 


ALWAYS 








INCREASE 


ALWAYS 








INVALIDATE 


ALWAYS 








REHABILITATE 


NEVER 






Logical Record 


Description 


Default Value 


M/0 


Length 


Number 










1 


Test Data 


00 00 00 


M 


3 bytes 


2 


Test Data 


00 00 00 


M 


3 bytes 



The file status shall be invaUdated as defined in GSM 11.11 [3 J . 
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Annex D (normative): 

sim.test.util package and loading , testing and cleaning 
script examples 

See attached files: 

Annex_D_SimTestUtil.zip. 
Annex_D_Examples.zip. 
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Annex E (normative): 
Test Area files 

See attached file: 

- Annex_E_SourceCode.zip. 
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Annex F (normative): 

AID numbering and acronyms for Framework tests 
F.1 Toolkit installation Parameters (TIN) 



Test Area within tlie chapter 


Acronyms 


Numbering on 6 bits 


Tinner allocation 


TMAL 


000001 


Item identifier 


HID 


000010 


Item position 


ITPO 


000011 


Access conditions 


ACCO 


010 


Priority level 


PRLV 


000101 


Maximum length for each menu entry 


MLME 


000110 


Number of menu entries 


NBME 


000111 


Memory space 


MESP 


001000 



F.2 Minimum Handler Availability (MHA) 



Test Area within the chapter 


Acronyms 


Numbering on 6 bits 


ProactiveHandler 


PAHD 


000001 


ProactiveResponseHandler 


PRHD 


000010 


EnvelopeHandler 


ENHD 


000011 


EnvelopeResponseHandler 


ERHD 


000100 



F.3 Handler Integrity (HIN) 



Test Area within the chapter 


Acronyms 


Numbering on 6 bits 


ProactiveHandler 


PAHD 


000001 


Proactive ResponseHandler 


PRHD 


000010 


EnvelopeHandler 


ENHD 


000011 


RFU (EnvelopeResponseHandler) 


(ERHD) 


000100 
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F.4 Applet Triggering (APT) 



Test Area within tlie chapter 


Acronyms 


Numbering on 6 bits 


EVENT PROFILE DOWNLOAD 


EPDW 


000001 


EVENT MENU SELECTION 


EMSE 


000010 


EVENT MENU SELECTION HELP REQUEST 


EMSH 


000011 


EVENT FORMATTED SMS PP ENV 


EFSE 


000100 


EVENT UNFORMATTED SMS PP ENV 


EUSE 


000101 


EVENT GALL CONTROL BY SIM 


ECCN 


000110 


EVENT MO SHORT MESSAGE CONTROL BY SIM 


EMCN 


000111 


EVENT TIMER EXPIRATION 


ETEX 


001000 


EVENT UNFORMATTED SMS CB 


EUCB 


001001 


EVENT EVENT DOWNLOAD MT CALL 


EDMC 


001010 


EVENT EVENT DOWNLOAD CALL CONNECTED 


EDCC 


001011 


tVcN 1 tVcN 1 UOWNLOAU OALL UlbOUNNtO 1 hU 


tuou 


n n 1 1 n n 
U U 1 1 u u 


EVENT EVENT DOWNLOAD LOCATION STATUS 


EDLS 


001101 


EVENT EVENT DOWNLOAD USER ACTIVITY 


EDUA 


001110 


EVENT EVENT DOWNLOAD IDLE SCREEN AVAILABLE 


EDIS 


001111 


EVENT EVENT DOWNLOAD CARD READER STATUS 


EDCR 


010000 


RFU (EVENT UNRECOGNIZED ENVELOPE) 


(EUEN) 


010001 


EVENT STATUS COMMAND 


ESTC 


010010 


EVENT EVENT DOWNLOAD LANGUAGE SELECTION 


EDLG 


010011 


EVENT EVENT DOWNLOAD BROWSER TERMINATION 


EDBT 


010100 


EVENT FORMATTED SMS CB 


EFCB 


010101 



F.5 Proactive Command Sending (PCS) 



Test Area within the chapter 


Acronyms 


Numbering on 6 bits 


System Proactive commands 


SPCO 


000001 


Interaction witti GSM commands 


IGCO 


000010 


Errors during proactive command sending 


EPCS 


000011 



F.6 Envelope Response Posting (ERP) 



Test Area within the chapter 


Acronyms 


Numbering on 6 bits 


EVENT CALL CONTROL BY SIM 


ECCN 


000001 


EVENT MO SHORT MESSAGE CONTROL BY SIM 


EMCN 


000010 


EVENT UNRECOGNIZED ENVELOPE 


EUEN 


000011 



F.7 Framework Security (FWS) 



Test Area within the chapter 


Acronyms 


Numbering on 6 bits 


Input data 


INDA 


000001 


Output data 


OUDA 


000010 
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F.8 File System Context (FSC) 



Test Area within tlie chapter 


Acronyms 


Numbering on 6 bits 


Initial Context 


INIT 


000001 


Context Preservation for Current File 


CUFI 


000010 


Context Preservation for Current Record 


CURE 


000011 



F.9 Exception Handling (EXH) 



Test Area within the chapter 


Acronyms 


Numbering on 6 bits 


Hide exception to the mobile 


HEME 


000001 


Interaction with multi-triggering 


IMTG 


000010 



F.1 Other parts transferred to framework from API (API) 



Test Area within the chapter 


Acronyms 


Numbering on 6 bits 


A handler is a temporary JCRE Entry Point object 


HEPO 


000001 


Transaction 


TRAN 


000010 


Timer Id between Applets 


TMID 


000011 
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Annex G (normative): 
Configuration Parameters File 

This file describes all the mandatory and optional parameters that are used in order to create the loading script(s) for one 
test area. The configuration parameters file contains the values for the parameters needed in order to generate the 
loading and cleanup scripts. 

The name of the parameters file will be <test area reference>_<n>.par. 

The number <n> is associated with the loading/cleanup script number, i.e. API_2_TKR_ SEVL_BSS_l.par is used to 
generate API_2_TKR_ SEVL_BSS_l.ldr etc. 



G.1 Syntax 

The general syntax for this file will be: 

<file> ::= <section>+ 

<section> : := <section heacling> <line break> <section body> 
<section heading> : := ' [ ' <name> '] ' 
<section body> : := <parameter assignment>+ 

<parameter assignment> : := <name> '=' <value> <line break> 
Where '+' indicates one or more repetitions of the previous syntax element. 

Any text included between the symbol ' ; ' and the end of Une is considered a comment and ignored by parsing tools. 
Empty values are considered valid. They are used to indicate that an optional value is not present. 

Names of sections, names of parameters and values are case-sensitive. 

Blank spaces and Tabs between tokens are allowed and will be ignored by the parser. 

When values represent a sequence of bytes, they are expressed in hexadecimal format, where every 2 digits represent 
one byte. Blank space between bytes is optional. 



EXAMPLE: 



; comment 




[ Sect ionl ] 




Parameterll 


= 00 11 22 33 


Parameterl2 


=0101 ; another comment 


[Section2] 




Parameter21 


= vvwwxxyyzz 
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G.2 File Contents and Organization 

Parameters in this file are orsanized in tlie followins sections. 



[CONVERT] 


Conversion parameters used during conversion (i.e. CAP file generation) 


[INSTALL(load)] 


Parameters used by tiie Install for Load command 


[LOAD] 


Parameters used by the Load command 


[INSTALL(install)] 


Parameters used by the Install for Install command 



All sections may appear only once in the file, except for the "INSTALL(install)" section. If that section appears more 
than once, it will apply to different applet instances, in sequence. 

G.2.1 Default values, order and processing 

The ordering of the parameters and the sections is relevant, since parameter names may be repeated and apply to 
different applets. 

When one single parameter is repeated within one section, it refers to different applets. The value of the n* appearance 
of the parameter applies to applet n. 

When one section is repeated (INSTALL(install)), then the n* appearance of the section applies to applet n. 
Parameter/value pairs which are found in one appearance of the section are valid for the subsequent applets as long as 
they are not overridden. For example, first INSTALL(install) may contain all values for parameters, whereas the 
subsequent INSTALL(install) sections may only contain parameters whose values change. 

If one required parameter is missing from one section, the last defined value of this parameter in a previous section of 
the same file will be used. 

G.2.2 CONVERT Section 



These parameters allow configuration of the conversion process of the Java class file(s) into one CAP file. 



Parameter 


Description 


PackageAID 


AID of the package 


PackageName 


Fully qualified name of the package 


PackageVersion 


Version of the package 


AppletClassAID 


AID of the applet 


AppletClassName 


Name of the applet 



G.2.3 INSTALL(load) Section 

Here are the parameters to be included in the Install(Load) command (as specified in GSM 03.48 [8]). 



Parameter 


Description 


PackageAID 


AID of the package 


PackageNonVolatileMemSize 


Non Volatile memory space (in bytes) required for package loading 


InstallationNonVolatileMemSize 


Non volatile memory required for installation, in bytes 


InstallatlonVolatllelVlemSIze 


Volatile memory required for installation, in bytes 
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G.2.4 LOAD Section 

Here are the parameters to be included in the Load command (as specified in GSM 03.48 [8]). 



Parameter 


Description 


MaxLoadCommandDataLength 


Maximum length of the data provided in the load command {P3 
parameter of the LOAD APDU embedded in the command packet) 



G.2.5 INSTALL(install) Section 

Here are the parameters to be included in the Install(Install) command (as specified in GSM 03.48 [8J). 



Parameter 


Description 


PackageAID 


AID of the package 


AppletClassAID 


AID of the applet 


InstanceAID 


AID of the instance of the applet 


InstallationNonVolatileMemSize 


Non volatile memory required for installation, in bytes 


InstallationVolatileMemSize 


Volatile memory required for installation, in bytes 


AccessDomain 


Specify the SIM files that may be accessed by the applet and the 
operations allowed on these files. This parameter includes the 
Access Domain Parameter (ADP) and Access Domain Data (ADD) 


PriorityLevel 


Priority level of the Toolkit applet instance 


MaxNumberOfTimers 


Maximum number of timers allowed for this applet instance 


MaxMenuEntryTextLength 


Maximum text length for a menu entry 


MaxNumberOfMenuEntries 


Maximum number of menu entries allowed for this applet instance 


Menu EntriesPosition Identifier 


For each menu entry: Position and identifier of that menu entry 


AppletSpecificParameters 


Parameters specific to the applet 



The applet shall be installed with install(install and make selectable) command. 



G.3 Full exannple 



[CONVERT] 

PackageAID = AO 00 00 00 30 00 02 FF FF FF FF 89 00 00 01 00 
PackageName = sim. test . access . api_l_svw_updrbs 
PackageVersion = 1.0 

AppletClassAID = AO 00 00 00 30 00 02 FF FF FF FF 89 00 00 01 01 
AppletClassName = API_1_SVW_UPDRBS_1 

AppletClassAID = AO 00 00 00 30 00 02 FF FF FF FF 89 00 00 01 02 
AppletClassName = API_1_SVW_UPDRBS_2 



[INSTALL (load) ] 

PackageNonVolatileMemSize = 0D27 
/InstallationNonVolatileMemSize = 0400 
/InstallationVolatileMemSize = 0000 



[ LOAD ] 

MaxLoadCommandDataLength = 6C ; max value 
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[INSTALL (install) ] 

AppletClassAID = AO 00 00 00 30 00 02 FF FF FF FF 89 00 00 01 01 

InstanceAID = AO 00 00 00 30 00 02 FF FF FF FF 89 00 00 01 01 

InstallationNonVolatileMemSize = 0400 

InstallationVolatileMemSize = 0000 

AccessDomain = 00 

PriorityLevel = FF 

MaxNumberOf Timers = 00 

MaxMenuEntryTextLength = 10 

MaxNumberOf MenuEntries = 01 

MenuEntriesPositionldentif ier = 0001 

AppletSpecif icParameters = 



[INSTALL (install) ] 

AppletClassAID = AO 00 00 00 30 00 02 FF FF FF FF 89 00 00 01 02 
InstanceAID = AO 00 00 00 30 00 02 FF FF FF FF 89 00 00 01 02 
InstallationNonVolatileMemSize = 0200 
InstallationVolatileMemSize = 0000 
MenuEntriesPositionldentif ier = 0002 



; rest of INSTALL (install) parameters are taken from previous INSTALL (install) .. . 
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Annex H (informative): 
Cliange history 



The table below indicates all changes that have been made to the present document since drafting work began. 



Change history 


Date 


TSG# 


TSG Doc 


CR 


Rev 


Cat 


Subject/Comment 


Old 


New 


2000-10 












Draft presented at T3 #1 6 




0.2.0 




TP-1 


TP-nnn?nR 

1 r UUU^UO 








1^ 1 C70C;I 1 It^U LU 1 0\JI 1 #IU lUI IlllUlllldllUII 


n ? n 


1 n n 


2001-01 












Input to T3 #1 7 resulting from T3 ad hoc #24 


1.0.0 


1.1.0 


2001-03 












Document presented for approval at T3 #18 


1.1.0 


1.2.0 


diJOl -06 


TO H H 

1 r-1 1 


I r-0 10041 








Document presented for approval to TSG-T #1 1 
l^iueruicai 111 lecnnicai conieriT lo vi.^i.uj 


1 .2.0 


2.0.0 


^uu 1 -Uo 












As approved at TSG-T #1 1 (id6ntical in tschnical content 
to V2.0.0) 


o n n 


"7 n n 


pnni -OR 












r^nrroptinn tn Hots nn f*r>\/or nsino / hosiHorc 


7 n n 


7 1 


2001-06 


TP-12 


TP-010105 


A001 




F 


Corrections to the API Test plan, addition of the test area 
files and modification of the until pacl^age 


7.0.1 


7.1.0 


2001-09 


TP-1 3 


TP-010206 


A002 




F 


Update API Test plan and Test Area Files 


7.1.0 


7.2.0 


2001-11 


TP-1 4 


TP-010241 


A003 




F 


Specification for framework part 


7.2.0 


7.3.0 


TP-010241 


A004 




F 


API part 


2002-03 


TP-1 5 


TP-020073 


004 




F 


Testing Frameworl^ Update 


7.3.0 


7.4.0 


2002-03 












Files for Annexes D and E added, Editorial correction 
performed in 6.3.2.3.3 column 9 (1- Applet triggered) 


7.4.0 


7.4.1 


2002-09 


T3#24 










Reference [14] cfianged as TS 101 220 v3.0.0 was 
withdrawn. 


7.4.1 


7.4.2 


2002-09 


TP-1 7 










Specification upgraded to release 99 without any 
changes. The technical content is identical to the 
previous version 7.4.2 


7.4.2 


8.0.0 


2002-12 


TP-1 8 


TP-020285 


A005 




F 


Update of 1 1 .13 Specification for Release 99 


8.0.0 


8.1.0 


2003-03 


TP-1 9 


TP-030026 


A006 




F 


Corrections on 1 1 .13 Specification 


8.1.0 


8.2.0 


2003-04 




Editorial modification; replacement of Annex E source 
code file. 


8.2.0 


8.2.1 
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